Confluence

Connect your Confluence data to Airweave

Overview

The Confluence connector allows you to sync data from Confluence into Airweave, making it available for search and retrieval by your agents.

Configuration

ConfluenceSource

Confluence source implementation, retrieving content in a hierarchical fashion.

This connector retrieves data from Confluence to yield the following entities:

Space
Page (including child pages as desired)
Blog Post
Comment
Label
Task
Whiteboard
Custom Content
(Optionally) Database, Folder, etc.

View Source Code

Explore the Confluence connector implementation

Authentication

This connector uses OAuth 2.0 with refresh token.

You can connect through the Airweave UI, which will guide you through the OAuth flow.

Entities

The following data models are available for this connector:

ConfluenceSpaceEntity

Schema for a Confluence Space.

See: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-spaces/

Field	Type	Description
space_key	str	Unique key for the space.
name	Optional[str]	Name of the space.
space_type	Optional[str]	Type of space (e.g. ‘global’).
description	Optional[str]	Description of the space.
status	Optional[str]	Status of the space if applicable.
created_at	Optional[datetime]	Timestamp when the space was created.
updated_at	Optional[datetime]	Timestamp when the space was last updated.

ConfluenceBlogPostEntity

Schema for a Confluence Blog Post.

See: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-blog-posts/

Field	Type	Description
content_id	Optional[str]	Actual Confluence blog post ID.
title	Optional[str]	Title of the blog post.
space_id	Optional[str]	ID of the space this blog post is in.
body	Optional[str]	HTML body of the blog post.
version	Optional[int]	Blog post version number.
status	Optional[str]	Status of the blog post (e.g., ‘current’).
created_at	Optional[datetime]	Timestamp when the blog post was created.
updated_at	Optional[datetime]	Timestamp when the blog post was last updated.

ConfluenceCommentEntity

Schema for a Confluence Comment.

See: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comments/

Field	Type	Description
content_id	Optional[str]	ID of the content this comment is attached to.
text	Optional[str]	Text/HTML body of the comment.
created_by	Optional[Dict[str, Any]]	Information about the user who created the comment.
created_at	Optional[datetime]	Timestamp when this comment was created.
updated_at	Optional[datetime]	Timestamp when this comment was last updated.
status	Optional[str]	Status of the comment (e.g., ‘current’).

ConfluenceDatabaseEntity

Schema for a Confluence Database object.

See: (the “database” content type in Confluence Cloud).

Field	Type	Description
title	Optional[str]	Title or name of the database.
space_key	Optional[str]	Space key for the database item.
description	Optional[str]	Description or extra info about the DB.
created_at	Optional[datetime]	Timestamp when the database was created.
updated_at	Optional[datetime]	Timestamp when the database was last updated.
status	Optional[str]	Status of the database content item.

ConfluenceFolderEntity

Schema for a Confluence Folder object.

See: (the “folder” content type in Confluence Cloud).

Field	Type	Description
title	Optional[str]	Name of the folder.
space_key	Optional[str]	Key of the space this folder is in.
created_at	Optional[datetime]	Timestamp when the folder was created.
updated_at	Optional[datetime]	Timestamp when the folder was last updated.
status	Optional[str]	Status of the folder (e.g., ‘current’).

ConfluenceLabelEntity

Schema for a Confluence Label object.

See: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-labels/

Field	Type	Description
name	str	The text value of the label.
label_type	Optional[str]	Type of the label (e.g., ‘global’).
owner_id	Optional[str]	ID of the user or content that owns label.

ConfluenceTaskEntity

Schema for a Confluence Task object.

For example, tasks extracted from Confluence pages or macros.

Field	Type	Description
content_id	Optional[str]	The content ID (page, blog, etc.) that this task is associated with.
space_key	Optional[str]	Space key if task is associated with a space.
text	Optional[str]	Text of the task.
assignee	Optional[Dict[str, Any]]	Information about the user assigned to this task.
completed	bool	Indicates if this task is completed.
due_date	Optional[datetime]	Due date/time if applicable.
created_at	Optional[datetime]	Timestamp when this task was created.
updated_at	Optional[datetime]	Timestamp when this task was last updated.

ConfluenceWhiteboardEntity

Schema for a Confluence Whiteboard object.

See: (the “whiteboard” content type in Confluence Cloud).

Field	Type	Description
title	Optional[str]	Title of the whiteboard.
space_key	Optional[str]	Key of the space this whiteboard is in.
created_at	Optional[datetime]	Timestamp when the whiteboard was created.
updated_at	Optional[datetime]	Timestamp when the whiteboard was last updated.
status	Optional[str]	Status of the whiteboard (e.g., ‘current’).

ConfluenceCustomContentEntity

Schema for a Confluence Custom Content object.

See: (the “custom content” type in Confluence Cloud).

Field	Type	Description
title	Optional[str]	Title or name of this custom content.
space_key	Optional[str]	Key of the space this content resides in.
body	Optional[str]	Optional HTML body or representation.
created_at	Optional[datetime]	Timestamp when the custom content was created.
updated_at	Optional[datetime]	Timestamp when the custom content was last updated.
status	Optional[str]	Status of the custom content item (e.g., ‘current’).