- Overview
- Setup Guide
- Permissions
- Troubleshooting
Confluence Cloud setup
Parable lists one Confluence Cloud Provider under Atlassian. In the connection wizard, use Authentication method to choose Email + API Token or OAuth 2.0 Client Credentials (2LO).Both methods sync the same taps: spaces, pages, page content, users, and audit logs.Data streams
This Provider Plugin defines 5 data streams.| Stream | Description | Sync |
|---|---|---|
spaces | Confluence spaces | full |
pages | Confluence pages | incremental |
page_content | Full page content including body | full |
users | Confluence users | full |
audit | Confluence audit logs | incremental |
Confluence
What You’ll Need
| Credential | What it is |
|---|---|
| API Token | Generated from Atlassian account settings |
| Email Address | Your Atlassian account email |
| Base URL | Your Confluence instance URL (e.g., https://your-company.atlassian.net) |
| Domain | Your Atlassian domain (e.g., your-company.atlassian.net) |
Prerequisites
- Confluence Administrator or Space Administrator for comprehensive data access
- View permission on spaces and pages you want to sync
Setup
- Create an API token at https://id.atlassian.com/manage-profile/security/api-tokens
- Note your Confluence site URL (
https://your-company.atlassian.net) and domain - In Parable, select Email + API Token, enter credentials and connection settings, then Save & test connection
Verify
curl -X GET "https://your-company.atlassian.net/wiki/rest/api/search/user?cql=type=user&limit=1" \
-u "your-email@company.com:YOUR_API_TOKEN" \
-H "Content-Type: application/json"
What You’ll Need
| Credential | What it is |
|---|---|
| Client ID | From the service account OAuth 2.0 credential in Atlassian Administration |
| Client Secret | From the same OAuth 2.0 credential |
| Cloud ID | Site identifier for api.atlassian.com gateway URLs |
Prerequisites
- Atlassian organization admin access to create service accounts and OAuth credentials
- Confluence product access granted to the service account on the target site
- Confluence permissions on the service account in addition to OAuth scopes
Setup
- In Atlassian Administration, create a service account and grant it Confluence access on the target site
- Create OAuth 2.0 credentials on that service account with these scopes:
read:space:confluenceread:space-details:confluenceread:page:confluenceread:user:confluenceread:audit-log:confluence
- Copy Client ID and Client Secret
- Find Cloud ID via admin console or
GET https://api.atlassian.com/oauth/token/accessible-resources(use the siteid) - In Parable, select OAuth 2.0 Client Credentials (2LO), enter Client ID, Client Secret, and Cloud ID, then Save & test connection
Verify
curl -X POST "https://auth.atlassian.com/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "audience=api.atlassian.com"
curl -s -H "Authorization: Bearer ACCESS_TOKEN" \
"https://api.atlassian.com/ex/confluence/CLOUD_ID/wiki/api/v2/spaces?limit=1"
OAuth scopes
| Scope | Purpose |
|---|---|
read:space:confluence | Spaces list |
read:space-details:confluence | Space details |
read:page:confluence | Pages and page content |
read:user:confluence | User directory |
read:audit-log:confluence | Audit logs |
Audit
Audit
auditAudit. Confluence audit logs.- Enables: Trace Confluence audit records to the author, affected object, action, category, source address, and creation time.
- Scope: Reads the records selected by Confluence Cloud’s
/wiki/rest/api/auditoperation as an event stream using incremental synchronization. This stream is opt-in. Visibility follows the Confluence account and space permissions associated with the credential. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. This stream supplies no reliable deletion signal.
Affected Object
Affected Object
audit.affectedObjectAffected Object. The primary object affected by the action. It preserves the nested context needed to interpret the parent audit.- Enables: Attribute affected object in
audit.affectedObjectto the parent audit; identify parent records where that nested affected object object is absent. - Interpretation: Confluence Cloud reports affected object as a nested object on each audit; optional children may be absent from a valid response.
Name
Name
audit.affectedObject.nameName. Name of the object. It gives the Confluence Cloud audit object a human-readable provider label while its identifier remains the stable reference.- Enables: Match repeated Confluence Cloud audit object entries on name in
audit.ConfluenceCloudAuditObject.name; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports name as display text for each Confluence Cloud audit object; names are mutable and are not stable identities. The connector explicitly marks this field as a transform deduplication key.
Object Type
Object Type
audit.affectedObject.objectTypeObject Type. Type of the object (e.g., ‘page’, ‘space’, ‘user’). It identifies the related provider object that gives the Confluence Cloud audit object its parent, owner, or container context.- Enables: Segment Confluence Cloud audit object entries in Audit by object type in
audit.ConfluenceCloudAuditObject.objectType; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports object type as a label from its own taxonomy on each Confluence Cloud audit object; preserve unknown labels rather than mapping them by assumption.
Associated Objects
Associated Objects
audit.associatedObjectsAssociated Objects. Additional objects associated with the action (e.g., parent objects). It preserves the nested context needed to interpret the parent audit.- Enables: Attribute every returned Confluence Cloud audit object in
audit.associatedObjectsto its parent audit; keep each relationship distinct and distinguish an absent array from an explicitly empty one. - Interpretation: Confluence Cloud returns associated objects as an array of Confluence Cloud audit object entries on each audit; missing, empty, and permission-redacted arrays are not equivalent.
Author
Author
audit.authorAuthor. User who performed the audited action. It preserves the nested context needed to interpret the parent audit.- Enables: Attribute author in
audit.authorto the parent audit; identify parent records where that nested author object is absent. - Interpretation: Confluence Cloud reports author as a nested object on each audit; optional children may be absent from a valid response.
Account ID
Account ID
audit.author.accountIdAccount ID. Atlassian account ID of the author. It provides the reference needed to connect the audit to the corresponding provider object.- Enables: Connect each Confluence Cloud audit author in Audit to the referenced account through
audit.ConfluenceCloudAuditAuthor.accountId; flag account ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports account ID as an identifier in its account namespace; it is not a universal identity outside Confluence Cloud.
Display Name
Display Name
audit.author.displayNameDisplay Name. Display name of the author. It distinguishes the provider-defined display name state or classification for the Confluence Cloud audit author.- Enables: Label each Confluence Cloud audit author with display name from
audit.ConfluenceCloudAuditAuthor.displayName; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports display name as display text for each Confluence Cloud audit author; names are mutable and are not stable identities.
Type
Type
audit.author.typeType. Author type (e.g., ‘user’). It identifies the related provider object that gives the Confluence Cloud audit author its parent, owner, or container context.- Enables: Segment Confluence Cloud audit author entries in Audit by type in
audit.ConfluenceCloudAuditAuthor.type; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports type as a label from its own taxonomy on each Confluence Cloud audit author; preserve unknown labels rather than mapping them by assumption.
Category
Category
audit.categoryCategory. Audit category (e.g., ‘permissions’, ‘pages’). It distinguishes the provider-defined category state or classification for the audit.- Enables: Segment audit entries in Audit by category in
audit.category; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports category as a label from its own taxonomy on each audit; preserve unknown labels rather than mapping them by assumption.
Changed Values
Changed Values
audit.changedValuesChanged Values. List of value changes recorded for the action. It preserves the nested context needed to interpret the parent audit.- Enables: Search the returned changed values content in
audit.changedValueswhile preserving element order and attribution to the parent audit. - Interpretation: Confluence Cloud returns changed values as ordered content or provider-generated content metadata on each audit; truncation, omission, and inaccessible source media can limit completeness.
Name
Name
audit.changedValues.nameName. Name of the changed field. It gives the Confluence Cloud audit changed value a human-readable provider label while its identifier remains the stable reference.- Enables: Match repeated Confluence Cloud audit changed value entries on name in
audit.ConfluenceCloudAuditChangedValue.name; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports name as display text for each Confluence Cloud audit changed value; names are mutable and are not stable identities. The connector explicitly marks this field as a transform deduplication key.
New Value
New Value
audit.changedValues.newValueNew Value. New value of the field. It must be interpreted with the enclosing provider field name, type, or custom schema for the Confluence Cloud audit changed value.- Enables: Interpret
audit.ConfluenceCloudAuditChangedValue.newValuewith the enclosing custom field name, declared type, and provider schema; compare only records that share that contract. - Interpretation: Confluence Cloud reports new value under the enclosing custom or typed field contract on each Confluence Cloud audit changed value; compare it only with values from the same provider key and type.
Old Value
Old Value
audit.changedValues.oldValueOld Value. Previous value of the field. It must be interpreted with the enclosing provider field name, type, or custom schema for the Confluence Cloud audit changed value.- Enables: Interpret
audit.ConfluenceCloudAuditChangedValue.oldValuewith the enclosing custom field name, declared type, and provider schema; compare only records that share that contract. - Interpretation: Confluence Cloud reports old value under the enclosing custom or typed field contract on each Confluence Cloud audit changed value; compare it only with values from the same provider key and type.
Creation Date
Creation Date
audit.creationDateCreation Date. Unix epoch milliseconds when the audit entry was created. It anchors the audit on the provider’s reported timeline.- Enables: Match repeated audit entries on creation date in
audit.creationDate; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports creation date in milliseconds since the Unix epoch on each audit; it is not ISO-8601 and must be converted with that explicit unit. The connector explicitly marks this field as a transform deduplication key. A connector directive uses this field to order records for latest-state or incremental processing. The schema designates this field as the event timestamp.
Description
Description
audit.descriptionDescription. Detailed description of the audited action. It defines the content surface available for this audit.- Enables: Locate audit records by description in
audit.description; attribute each text match to its parent audit and, when present, its reported author. - Interpretation: Confluence Cloud supplies description as text on each audit; referenced files or media are not implied unless explicitly represented.
Remote Address
Remote Address
audit.remoteAddressRemote Address. Remote IP address from which the action was performed. It supplies the provider-reported address or location facet for the audit, not a residency determination.- Enables: Group Audit by the exact remote address in
audit.remoteAddresswhile keeping that address or location separate from geolocation and residency claims. - Interpretation: Confluence Cloud reports remote address as an address or location facet on each audit; it does not establish verified geolocation or data residency.
Summary
Summary
audit.summarySummary. Short human-readable summary of the audited action. It defines the content surface available for this audit.- Enables: Locate audit records by summary in
audit.summary; attribute each text match to its parent audit and, when present, its reported author. - Interpretation: Confluence Cloud supplies summary as text on each audit; referenced files or media are not implied unless explicitly represented.
Super Admin
Super Admin
audit.superAdminSuper Admin. Whether the action was performed by a super administrator. It distinguishes the provider-defined super admin state or classification for the audit.- Enables: Filter Audit by whether the action was performed by a super administrator in
audit.superAdmin; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports the action was performed by a super administrator as a boolean on each audit; a missing field is unknown, not false.
Sys Admin
Sys Admin
audit.sysAdminSys Admin. Whether the action was performed by a system administrator. It distinguishes the provider-defined sys admin state or classification for the audit.- Enables: Filter Audit by whether the action was performed by a system administrator in
audit.sysAdmin; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports the action was performed by a system administrator as a boolean on each audit; a missing field is unknown, not false.
Page Content
Page Content
page_contentPage Content. Full page content including body.- Enables: Search the full page body representation returned by Confluence and attribute it to the page and version.
- Scope: Reads the records selected by Confluence Cloud’s
/wiki/api/v2/pages/{id}operation as a snapshot stream using full synchronization. This stream is opt-in. Visibility follows the Confluence account and space permissions associated with the credential. The returned page body is included, but binary attachments and content hidden from the credential are not. A later complete read can treat a previously seen record that is absent as removed.
Author ID
Author ID
page_content.authorIdAuthor ID. Account ID of the page creator. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced author through
page_content.authorId; flag author ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports author ID as an identifier in its author namespace; it is not a universal identity outside Confluence Cloud.
Body
Body
page_content.bodyBody. Body content of the page in the requested representation(s). It preserves the nested context needed to interpret the parent page content.- Enables: Attribute body in
page_content.bodyto the parent page content; identify parent records where that nested body object is absent. - Interpretation: Confluence Cloud reports body as a nested object on each page content; optional children may be absent from a valid response.
Atlas Doc Format
Atlas Doc Format
page_content.body.atlas_doc_formatAtlas Doc Format. Page body in Atlassian Document Format (JSON-based). It preserves the nested context needed to interpret the parent page content.- Enables: Attribute atlas doc format in
page_content.PageContentBody.atlas_doc_formatto the parent page content; identify parent records where that nested atlas doc format object is absent. - Interpretation: Confluence Cloud reports atlas doc format as a nested object on each page content body; optional children may be absent from a valid response.
Representation
Representation
page_content.body.atlas_doc_format.representationRepresentation. The representation type identifier (e.g., ‘storage’, ‘atlas_doc_format’). It identifies the related provider object that gives the page content body representation its parent, owner, or container context.- Enables: Connect each page content body representation to the related representation in
page_content.PageContentBodyRepresentation.representationand verify that the referenced provider object resolves in the expected parent or container. - Interpretation: Confluence Cloud reports representation as relationship context on each page content body representation; resolve it in the named provider namespace rather than by display text alone.
Value
Value
page_content.body.atlas_doc_format.valueValue. The body content string in the given representation format. It supplies the returned value text needed to understand the page content body representation in context.- Enables: Search the returned value text in
page_content.PageContentBodyRepresentation.valueand attribute each match to its parent page content and reported author when available. - Interpretation: Confluence Cloud supplies value as returned text on each page content body representation; truncation, formatting, and access boundaries can limit completeness.
Storage
Storage
page_content.body.storageStorage. Page body in Confluence storage format (XHTML-based). It preserves the nested context needed to interpret the parent page content.- Enables: Attribute storage in
page_content.PageContentBody.storageto the parent page content; identify parent records where that nested storage object is absent. - Interpretation: Confluence Cloud reports storage as a nested object on each page content body; optional children may be absent from a valid response.
Created At
Created At
page_content.createdAtCreated At. Timestamp when the page was originally created (ISO 8601). It anchors the page content on the provider’s reported timeline.- Enables: Order Page Content by created at in
page_content.createdAtand isolate records inside an exact provider reporting window. - Interpretation: Confluence Cloud reports created at as a timestamp on each page content; timezone and precision follow this API field, and absence is not an inferred event time.
ID
ID
page_content.idID. Unique identifier for the page. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Match repeated page content entries on ID in
page_content.id; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports ID as an identifier in its page content namespace; it is not a universal identity outside Confluence Cloud. The connector explicitly marks this field as a transform deduplication key.
Last Owner ID
Last Owner ID
page_content.lastOwnerIdLast Owner ID. Account ID of the previous page owner. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced last owner through
page_content.lastOwnerId; flag last owner ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports last owner ID as an identifier in its last owner namespace; it is not a universal identity outside Confluence Cloud.
Owner ID
Owner ID
page_content.ownerIdOwner ID. Account ID of the page owner. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced owner through
page_content.ownerId; flag owner ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports owner ID as an identifier in its owner namespace; it is not a universal identity outside Confluence Cloud.
Page ID
Page ID
page_content.page_idPage ID. Parent page reference copied into each page content because the child operation does not return that relationship. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced page through
page_content.page_id; flag page ID values that do not resolve in that provider namespace. - Interpretation: Parable copies page ID from the parent traversal record into each page content; the child Confluence Cloud operation does not return it.
Parent ID
Parent ID
page_content.parentIdParent ID. ID of the parent page, if any. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced parent through
page_content.parentId; flag parent ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports parent ID as an identifier in its parent namespace; it is not a universal identity outside Confluence Cloud.
Parent Type
Parent Type
page_content.parentTypeParent Type. Type of the parent entity (page or space). It identifies the related provider object that gives the page content its parent, owner, or container context.- Enables: Segment page content entries in Page Content by parent type in
page_content.parentType; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports parent type as a label from its own taxonomy on each page content; preserve unknown labels rather than mapping them by assumption.
Position
Position
page_content.positionPosition. The position of the page relative to its siblings in the page tree. It supplies the position measure for the page content at the provider’s declared unit and grain.- Enables: Measure position through
page_content.positionfor each page content and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports position as a measure on each page content; compare only records with the same unit and aggregation grain.
Space ID
Space ID
page_content.spaceIdSpace ID. ID of the space containing this page. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content in Page Content to the referenced space through
page_content.spaceId; flag space ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports space ID as an identifier in its space namespace; it is not a universal identity outside Confluence Cloud.
Status
Status
page_content.statusStatus. Page status (current, archived, trashed, draft, deleted). It distinguishes the provider-defined status state or classification for the page content.- Enables: Segment page content entries in Page Content by status in
page_content.status; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports status as a label from its own taxonomy on each page content; preserve unknown labels rather than mapping them by assumption.
Title
Title
page_content.titleTitle. Title of the page. It gives the page content a human-readable provider label while its identifier remains the stable reference.- Enables: Label each page content with title from
page_content.title; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports title as display text for each page content; names are mutable and are not stable identities.
Version
Version
page_content.versionVersion. Version information for the latest revision of the page. It preserves the nested context needed to interpret the parent page content.- Enables: Attribute version in
page_content.versionto the parent page content; identify parent records where that nested version object is absent. - Interpretation: Confluence Cloud reports version as a nested object on each page content; optional children may be absent from a valid response.
Author ID
Author ID
page_content.version.authorIdAuthor ID. Account ID of the user who made this version edit. It provides the reference needed to connect the page content to the corresponding provider object.- Enables: Connect each page content version in Page Content to the referenced author through
page_content.PageContentVersion.authorId; flag author ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports author ID as an identifier in its author namespace; it is not a universal identity outside Confluence Cloud.
Created At
Created At
page_content.version.createdAtCreated At. Timestamp when this version was created. It anchors the page content on the provider’s reported timeline.- Enables: Order Page Content by created at in
page_content.PageContentVersion.createdAtand isolate records inside an exact provider reporting window. - Interpretation: Confluence Cloud reports created at as a timestamp on each page content version; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
Message
Message
page_content.version.messageMessage. Optional message provided by the editor for this version. It supplies the returned message text needed to understand the page content version in context.- Enables: Search the returned message text in
page_content.PageContentVersion.messageand attribute each match to its parent page content and reported author when available. - Interpretation: Confluence Cloud supplies message as returned text on each page content version; truncation, formatting, and access boundaries can limit completeness.
Minor Edit
Minor Edit
page_content.version.minorEditMinor Edit. Whether this version was flagged as a minor edit. It distinguishes the provider-defined minor edit state or classification for the page content version.- Enables: Filter Page Content by whether this version was flagged as a minor edit in
page_content.PageContentVersion.minorEdit; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports this version was flagged as a minor edit as a boolean on each page content version; a missing field is unknown, not false.
Number
Number
page_content.version.numberNumber. Version number indicating how many times the page has been edited. It supplies the number measure for the page content version at the provider’s declared unit and grain.- Enables: Measure number through
page_content.PageContentVersion.numberfor each page content version and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports number as a measure on each page content version; compare only records with the same unit and aggregation grain.
Pages
Pages
pagesPages. Confluence pages.- Enables: Inventory Confluence page metadata and connect each page to its space, parent, author, and content fetch.
- Scope: Reads the records selected by Confluence Cloud’s
/wiki/api/v2/pagesoperation as a snapshot stream using incremental synchronization. Visibility follows the Confluence account and space permissions associated with the credential. Page list records are metadata; the separate page-content stream carries the returned body representation. This stream supplies no reliable deletion signal.
Links
Links
pages._linksLinks. Links related to this page resource. It preserves the nested context needed to interpret the parent page.- Enables: Attribute links in
pages._linksto the parent page; identify parent records where that nested links object is absent. - Interpretation: Confluence Cloud reports links as a nested object on each page; optional children may be absent from a valid response.
Base
Base
pages._links.baseBase. Base URL of the Confluence instance. It locates the provider resource or path associated with the page link.- Enables: Associate each page link with the resource identified by base in
pages.PageLinks.base; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports base as a resource locator for each page link; access still depends on viewer permissions and the URL may expire or change.
Editui
Editui
pages._links.edituiEditui. Relative URL to edit the page in the Confluence web UI. It locates the provider resource or path associated with the page link.- Enables: Resolve the page’s provider resource or path through
pages.PageLinks.editui; verify access separately and do not infer that linked content was ingested. - Interpretation: Confluence Cloud returns editui as a resource locator or path for each page link; access can expire or depend on viewer permissions, and linked content is not implied.
Next
Next
pages._links.nextNext. URL or relative path for the next page of results (pagination). It is needed to continue the provider result set without skipping or repeating a page.- Enables: Resume Confluence Cloud pagination from
pages.PageLinks.nextand verify that every page boundary advances before requesting the next result set. - Interpretation: Confluence Cloud returns next as opaque pagination state; it has no business meaning and must be replayed exactly when requesting the next page.
Self
Self
pages._links.selfSelf. Full API URL for this page resource. It locates the provider resource or path associated with the page link.- Enables: Associate each page link with the resource identified by self in
pages.PageLinks.self; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports self as a resource locator for each page link; access still depends on viewer permissions and the URL may expire or change.
Tinyui
Tinyui
pages._links.tinyuiTinyui. Short relative URL (tiny link) for the page. It locates the provider resource or path associated with the page link.- Enables: Resolve the page’s provider resource or path through
pages.PageLinks.tinyui; verify access separately and do not infer that linked content was ingested. - Interpretation: Confluence Cloud returns tinyui as a resource locator or path for each page link; access can expire or depend on viewer permissions, and linked content is not implied.
Webui
Webui
pages._links.webuiWebui. Relative URL to the page in the Confluence web UI. It is needed to continue the provider result set without skipping or repeating a page.- Enables: Resume Confluence Cloud pagination from
pages.PageLinks.webuiand verify that every page boundary advances before requesting the next result set. - Interpretation: Confluence Cloud returns webui as opaque pagination state; it has no business meaning and must be replayed exactly when requesting the next page.
Author ID
Author ID
pages.authorIdAuthor ID. Account ID of the page creator. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page in Pages to the referenced author through
pages.authorId; flag author ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports author ID as an identifier in its author namespace; it is not a universal identity outside Confluence Cloud.
Body
Body
pages.bodyBody. Body content of the page in the requested format. It preserves the nested context needed to interpret the parent page.- Enables: Attribute body in
pages.bodyto the parent page; identify parent records where that nested body object is absent. - Interpretation: Confluence Cloud reports body as a nested object on each page; optional children may be absent from a valid response.
Atlas Doc Format
Atlas Doc Format
pages.body.atlas_doc_formatAtlas Doc Format. Page body in Atlassian Document Format (JSON-based). It preserves the nested context needed to interpret the parent page.- Enables: Attribute atlas doc format in
pages.PageBody.atlas_doc_formatto the parent page; identify parent records where that nested atlas doc format object is absent. - Interpretation: Confluence Cloud reports atlas doc format as a nested object on each page body; optional children may be absent from a valid response.
Representation
Representation
pages.body.atlas_doc_format.representationRepresentation. The representation type identifier (e.g., ‘storage’, ‘atlas_doc_format’). It identifies the related provider object that gives the body representation its parent, owner, or container context.- Enables: Connect each body representation to the related representation in
pages.BodyRepresentation.representationand verify that the referenced provider object resolves in the expected parent or container. - Interpretation: Confluence Cloud reports representation as relationship context on each body representation; resolve it in the named provider namespace rather than by display text alone.
Value
Value
pages.body.atlas_doc_format.valueValue. The body content string in the given representation format. It supplies the returned value text needed to understand the body representation in context.- Enables: Search the returned value text in
pages.BodyRepresentation.valueand attribute each match to its parent page and reported author when available. - Interpretation: Confluence Cloud supplies value as returned text on each body representation; truncation, formatting, and access boundaries can limit completeness.
Storage
Storage
pages.body.storageStorage. Page body in Confluence storage format (XHTML-based). It preserves the nested context needed to interpret the parent page.- Enables: Attribute storage in
pages.PageBody.storageto the parent page; identify parent records where that nested storage object is absent. - Interpretation: Confluence Cloud reports storage as a nested object on each page body; optional children may be absent from a valid response.
Created At
Created At
pages.createdAtCreated At. Timestamp when the page was originally created (ISO 8601). It anchors the page on the provider’s reported timeline.- Enables: Order Pages by created at in
pages.createdAtand isolate records inside an exact provider reporting window. - Interpretation: Confluence Cloud reports created at as a timestamp on each page; timezone and precision follow this API field, and absence is not an inferred event time.
ID
ID
pages.idID. Unique identifier for the page. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Match repeated page entries on ID in
pages.id; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports ID as an identifier in its page namespace; it is not a universal identity outside Confluence Cloud. The connector explicitly marks this field as a transform deduplication key.
Last Owner ID
Last Owner ID
pages.lastOwnerIdLast Owner ID. Account ID of the previous page owner. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page in Pages to the referenced last owner through
pages.lastOwnerId; flag last owner ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports last owner ID as an identifier in its last owner namespace; it is not a universal identity outside Confluence Cloud.
Owner ID
Owner ID
pages.ownerIdOwner ID. Account ID of the page owner (may differ from author). It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page in Pages to the referenced owner through
pages.ownerId; flag owner ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports owner ID as an identifier in its owner namespace; it is not a universal identity outside Confluence Cloud.
Parent ID
Parent ID
pages.parentIdParent ID. ID of the parent page, if any. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page in Pages to the referenced parent through
pages.parentId; flag parent ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports parent ID as an identifier in its parent namespace; it is not a universal identity outside Confluence Cloud.
Parent Type
Parent Type
pages.parentTypeParent Type. Type of the parent entity (page or space). It distinguishes the provider-defined parent type state or classification for the page.- Enables: Segment page entries in Pages by parent type in
pages.parentType; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports parent type as a label from its own taxonomy on each page; preserve unknown labels rather than mapping them by assumption.
Position
Position
pages.positionPosition. The position of the page relative to its siblings in the page tree. It supplies the position measure for the page at the provider’s declared unit and grain.- Enables: Measure position through
pages.positionfor each page and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports position as a measure on each page; compare only records with the same unit and aggregation grain.
Space ID
Space ID
pages.spaceIdSpace ID. ID of the space containing this page. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page in Pages to the referenced space through
pages.spaceId; flag space ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports space ID as an identifier in its space namespace; it is not a universal identity outside Confluence Cloud.
Status
Status
pages.statusStatus. Page status (current, archived, trashed, draft, etc.). It distinguishes the provider-defined status state or classification for the page.- Enables: Segment page entries in Pages by status in
pages.status; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports status as a label from its own taxonomy on each page; preserve unknown labels rather than mapping them by assumption.
Title
Title
pages.titleTitle. Title of the page. It gives the page a human-readable provider label while its identifier remains the stable reference.- Enables: Label each page with title from
pages.title; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports title as display text for each page; names are mutable and are not stable identities.
Version
Version
pages.versionVersion. Version information for the latest revision of the page. It preserves the nested context needed to interpret the parent page.- Enables: Attribute version in
pages.versionto the parent page; identify parent records where that nested version object is absent. - Interpretation: Confluence Cloud reports version as a nested object on each page; optional children may be absent from a valid response.
Author ID
Author ID
pages.version.authorIdAuthor ID. Account ID of the user who made this version edit. It provides the reference needed to connect the page to the corresponding provider object.- Enables: Connect each page version in Pages to the referenced author through
pages.PageVersion.authorId; flag author ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports author ID as an identifier in its author namespace; it is not a universal identity outside Confluence Cloud.
Created At
Created At
pages.version.createdAtCreated At. Timestamp when this version was created (effectively the last modified date). It anchors the page on the provider’s reported timeline.- Enables: Order Pages by created at in
pages.PageVersion.createdAtand isolate records inside an exact provider reporting window. - Interpretation: Confluence Cloud reports created at as a timestamp on each page version; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
Message
Message
pages.version.messageMessage. Optional message provided by the editor for this version. It supplies the returned message text needed to understand the page version in context.- Enables: Search the returned message text in
pages.PageVersion.messageand attribute each match to its parent page and reported author when available. - Interpretation: Confluence Cloud supplies message as returned text on each page version; truncation, formatting, and access boundaries can limit completeness.
Minor Edit
Minor Edit
pages.version.minorEditMinor Edit. Whether this version was flagged as a minor edit. It distinguishes the provider-defined minor edit state or classification for the page version.- Enables: Filter Pages by whether this version was flagged as a minor edit in
pages.PageVersion.minorEdit; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports this version was flagged as a minor edit as a boolean on each page version; a missing field is unknown, not false.
Number
Number
pages.version.numberNumber. Version number indicating how many times the page has been edited. It supplies the number measure for the page version at the provider’s declared unit and grain.- Enables: Measure number through
pages.PageVersion.numberfor each page version and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports number as a measure on each page version; compare only records with the same unit and aggregation grain.
Spaces
Spaces
spacesSpaces. Confluence spaces.- Enables: Inventory Confluence spaces by key, name, type, status, homepage, author, and creation time.
- Scope: Reads the records selected by Confluence Cloud’s
/wiki/api/v2/spacesoperation as a snapshot stream using full synchronization. Visibility follows the Confluence account and space permissions associated with the credential. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. A later complete read can treat a previously seen record that is absent as removed.
Links
Links
spaces._linksLinks. Links related to this space resource. It preserves the nested context needed to interpret the parent space.- Enables: Attribute links in
spaces._linksto the parent space; identify parent records where that nested links object is absent. - Interpretation: Confluence Cloud reports links as a nested object on each space; optional children may be absent from a valid response.
Self
Self
spaces._links.selfSelf. Self link URL for the space API resource. It locates the provider resource or path associated with the space link.- Enables: Associate each space link with the resource identified by self in
spaces.SpaceLinks.self; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports self as a resource locator for each space link; access still depends on viewer permissions and the URL may expire or change.
Webui
Webui
spaces._links.webuiWebui. Relative web UI path for the space. It is needed to continue the provider result set without skipping or repeating a page.- Enables: Resume Confluence Cloud pagination from
spaces.SpaceLinks.webuiand verify that every page boundary advances before requesting the next result set. - Interpretation: Confluence Cloud returns webui as opaque pagination state; it has no business meaning and must be replayed exactly when requesting the next page.
Author ID
Author ID
spaces.authorIdAuthor ID. Account ID of the space creator. It provides the reference needed to connect the space to the corresponding provider object.- Enables: Connect each space in Spaces to the referenced author through
spaces.authorId; flag author ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports author ID as an identifier in its author namespace; it is not a universal identity outside Confluence Cloud.
Created At
Created At
spaces.createdAtCreated At. ISO 8601 timestamp when the space was created. It anchors the space on the provider’s reported timeline.- Enables: Order Spaces by created at in
spaces.createdAtand isolate records inside an exact provider reporting window. - Interpretation: Confluence Cloud reports created at as a timestamp on each space; timezone and precision follow this API field, and absence is not an inferred event time.
Current Active Alias
Current Active Alias
spaces.currentActiveAliasCurrent Active Alias. Human-readable alias currently in use for the space. For spaces created under the new space-key model this is the value users see and reference, and it can differ from key. It identifies the related provider object that gives the space its parent, owner, or container context.- Enables: Connect each space to the related current active alias in
spaces.currentActiveAliasand verify that the referenced provider object resolves in the expected parent or container. - Interpretation: Confluence Cloud reports current active alias as relationship context on each space; resolve it in the named provider namespace rather than by display text alone.
Description
Description
spaces.descriptionDescription. Description of the space in the requested format. It preserves the nested context needed to interpret the parent space.- Enables: Attribute description in
spaces.descriptionto the parent space; identify parent records where that nested description object is absent. - Interpretation: Confluence Cloud reports description as a nested object on each space; optional children may be absent from a valid response.
Plain
Plain
spaces.description.plainPlain. Plain text representation of the space description. It preserves the nested context needed to interpret the parent space.- Enables: Attribute plain in
spaces.SpaceDescription.plainto the parent space; identify parent records where that nested plain object is absent. - Interpretation: Confluence Cloud reports plain as a nested object on each space description; optional children may be absent from a valid response.
Representation
Representation
spaces.description.plain.representationRepresentation. The representation format (e.g., ‘plain’, ‘view’). It must be interpreted with the enclosing provider field name, type, or custom schema for the space description body.- Enables: Interpret
spaces.SpaceDescriptionBody.representationwith the enclosing custom field name, declared type, and provider schema; compare only records that share that contract. - Interpretation: Confluence Cloud reports representation under the enclosing custom or typed field contract on each space description body; compare it only with values from the same provider key and type.
Value
Value
spaces.description.plain.valueValue. The description content in the given representation. It supplies the returned value text needed to understand the space description body in context.- Enables: Search the returned value text in
spaces.SpaceDescriptionBody.valueand attribute each match to its parent space and reported author when available. - Interpretation: Confluence Cloud supplies value as returned text on each space description body; truncation, formatting, and access boundaries can limit completeness.
View
View
spaces.description.viewView. View (rendered HTML) representation of the space description. It preserves the nested context needed to interpret the parent space.- Enables: Attribute view in
spaces.SpaceDescription.viewto the parent space; identify parent records where that nested view object is absent. - Interpretation: Confluence Cloud reports view as a nested object on each space description; optional children may be absent from a valid response.
Homepage ID
Homepage ID
spaces.homepageIdHomepage ID. ID of the space’s homepage content. It provides the reference needed to connect the space to the corresponding provider object.- Enables: Connect each space in Spaces to the referenced homepage through
spaces.homepageId; flag homepage ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports homepage ID as an identifier in its homepage namespace; it is not a universal identity outside Confluence Cloud.
Icon
Icon
spaces.iconIcon. Icon associated with the space. Only present when include-icon is true. It preserves the nested context needed to interpret the parent space.- Enables: Attribute icon in
spaces.iconto the parent space; identify parent records where that nested icon object is absent. - Interpretation: Confluence Cloud reports icon as a nested object on each space; optional children may be absent from a valid response.
API Download Link
API Download Link
spaces.icon.apiDownloadLinkAPI Download Link. API download link for the space icon. It locates the provider resource or path associated with the space icon.- Enables: Associate each space icon with the resource identified by API download link in
spaces.SpaceIcon.apiDownloadLink; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports API download link as a resource locator for each space icon; access still depends on viewer permissions and the URL may expire or change.
Path
Path
spaces.icon.pathPath. Relative path to the space icon image. It locates the provider resource or path associated with the space icon.- Enables: Resolve the space’s provider resource or path through
spaces.SpaceIcon.path; verify access separately and do not infer that linked content was ingested. - Interpretation: Confluence Cloud returns path as a resource locator or path for each space icon; access can expire or depend on viewer permissions, and linked content is not implied.
ID
ID
spaces.idID. Unique identifier for the space. It provides the reference needed to connect the space to the corresponding provider object.- Enables: Match repeated space entries on ID in
spaces.id; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports ID as an identifier in its space namespace; it is not a universal identity outside Confluence Cloud. The connector explicitly marks this field as a transform deduplication key.
Key
Key
spaces.keyKey. Short unique key for the space (e.g., ‘ENG’). It provides the reference needed to connect the space to the corresponding provider object.- Enables: Connect each space in Spaces to the referenced space through
spaces.key; flag key values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports key as an identifier in its space namespace; it is not a universal identity outside Confluence Cloud.
Name
Name
spaces.nameName. Display name of the space. It gives the space a human-readable provider label while its identifier remains the stable reference.- Enables: Label each space with name from
spaces.name; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports name as display text for each space; names are mutable and are not stable identities.
Status
Status
spaces.statusStatus. Space status (current or archived). It distinguishes the provider-defined status state or classification for the space.- Enables: Segment space entries in Spaces by status in
spaces.status; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports status as a label from its own taxonomy on each space; preserve unknown labels rather than mapping them by assumption.
Type
Type
spaces.typeType. Space type (global or personal). It distinguishes the provider-defined type state or classification for the space.- Enables: Segment space entries in Spaces by type in
spaces.type; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports type as a label from its own taxonomy on each space; preserve unknown labels rather than mapping them by assumption.
Users
Users
usersUsers. Confluence users.- Enables: Reconcile Confluence account identifiers and display names to account type and active status when visible to the credential.
- Scope: Reads the records selected by Confluence Cloud’s
/wiki/rest/api/search/useroperation as a snapshot stream using full synchronization. Visibility follows the Confluence account and space permissions associated with the credential. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. A later complete read can treat a previously seen record that is absent as removed.
Links
Links
users._linksLinks. HAL-style links related to this user resource. It preserves the nested context needed to interpret the parent user.- Enables: Attribute links in
users._linksto the parent user; identify parent records where that nested links object is absent. - Interpretation: Confluence Cloud reports links as a nested object on each user; optional children may be absent from a valid response.
Base
Base
users._links.baseBase. Base URL of the Confluence instance. It locates the provider resource or path associated with the Confluence Cloud user link.- Enables: Associate each Confluence Cloud user link with the resource identified by base in
users.ConfluenceCloudUserLinks.base; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports base as a resource locator for each Confluence Cloud user link; access still depends on viewer permissions and the URL may expire or change.
Next
Next
users._links.nextNext. Relative URL for the next page of results (present only in list envelope, included here for completeness). It is needed to continue the provider result set without skipping or repeating a page.- Enables: Resume Confluence Cloud pagination from
users.ConfluenceCloudUserLinks.nextand verify that every page boundary advances before requesting the next result set. - Interpretation: Confluence Cloud returns next as opaque pagination state; it has no business meaning and must be replayed exactly when requesting the next page.
Self
Self
users._links.selfSelf. Full URL to the user API resource. It locates the provider resource or path associated with the Confluence Cloud user link.- Enables: Associate each Confluence Cloud user link with the resource identified by self in
users.ConfluenceCloudUserLinks.self; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports self as a resource locator for each Confluence Cloud user link; access still depends on viewer permissions and the URL may expire or change.
Account ID
Account ID
users.accountIdAccount ID. Unique Atlassian account ID for the user. Primary key for cross-referencing users across all Confluence content and Atlassian products. It provides the reference needed to connect the user to the corresponding provider object.- Enables: Match repeated user entries on account ID in
users.accountId; collapse only entries that share this declared transform key. - Interpretation: Confluence Cloud reports account ID as an identifier in its account namespace; it is not a universal identity outside Confluence Cloud. The connector explicitly marks this field as a transform deduplication key. A connector directive maps this field to account identity.
Account Type
Account Type
users.accountTypeAccount Type. Type of account. Distinguishes human users from service accounts for accurate tool adoption metrics. It distinguishes the provider-defined account type state or classification for the user.- Enables: Segment user entries in Users by account type in
users.accountType; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports account type as a label from its own taxonomy on each user; preserve unknown labels rather than mapping them by assumption.
Display Name
Display Name
users.displayNameDisplay Name. Display name shown in the UI. Fallback display name for user identification. It distinguishes the provider-defined display name state or classification for the user.- Enables: Label each user with display name from
users.displayName; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports display name as display text for each user; names are mutable and are not stable identities. A connector directive maps this field to a person’s display name.
Email
users.emailEmail. Email address of the user. Primary cross-connector identity resolution field for matching users across SaaS tools. It supplies the provider-reported address or location facet for the user, not a residency determination.- Enables: Attribute each user to a person or account by the exact email in
users.email; identify addresses that do not match the Confluence Cloud directory. - Interpretation: Confluence Cloud reports email as an address on each user; aliases, casing, and unverified addresses can prevent a one-to-one person match. A connector directive maps this field to a person’s email identity.
Is External Collaborator
Is External Collaborator
users.isExternalCollaboratorIs External Collaborator. Whether the user is an external collaborator (guest) in the Confluence instance. It distinguishes the provider-defined is external collaborator state or classification for the user.- Enables: Filter Users by whether the user is an external collaborator (guest) in the confluence instance in
users.isExternalCollaborator; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports the user is an external collaborator (guest) in the confluence instance as a boolean on each user; a missing field is unknown, not false.
Operations
Operations
users.operationsOperations. List of permitted operations for this user in the current context. It preserves the nested context needed to interpret the parent user.- Enables: Compare the exact Confluence Cloud-configured operations set in
users.operationsfor each user; preserve provider labels and unknown entries. - Interpretation: Confluence Cloud returns operations as an array of Confluence Cloud operation entries on each user; missing, empty, and permission-redacted arrays are not equivalent.
Operation
Operation
users.operations.operationOperation. The operation type, e.g. ‘use’, ‘create’, ‘read’, ‘update’, ‘delete’, ‘administer’. It distinguishes the provider-defined operation state or classification for the Confluence Cloud operation.- Enables: Filter Users by the exact Confluence Cloud-defined operation in
users.ConfluenceCloudOperation.operationand preserve unknown values as distinct categories. - Interpretation: Confluence Cloud supplies operation from its own taxonomy on each Confluence Cloud operation; preserve unknown and newly introduced labels.
Target Type
Target Type
users.operations.targetTypeTarget Type. The target entity type the operation applies to, e.g. ‘page’, ‘blogpost’, ‘space’, ‘application’. It identifies the related provider object that gives the Confluence Cloud operation its parent, owner, or container context.- Enables: Segment Confluence Cloud operation entries in Users by target type in
users.ConfluenceCloudOperation.targetType; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports target type as a label from its own taxonomy on each Confluence Cloud operation; preserve unknown labels rather than mapping them by assumption.
Personal Space
Personal Space
users.personalSpacePersonal Space. Reference to the user’s personal space, if one exists. It preserves the nested context needed to interpret the parent user.- Enables: Attribute personal space in
users.personalSpaceto the parent user; identify parent records where that nested personal space object is absent. - Interpretation: Confluence Cloud reports personal space as a nested object on each user; optional children may be absent from a valid response.
Links
Links
users.personalSpace._linksLinks. Links related to this space. It preserves the nested context needed to interpret the parent user.- Enables: Attribute links in
users.ConfluenceCloudPersonalSpace._linksto the parent user; identify parent records where that nested links object is absent. - Interpretation: Confluence Cloud reports links as a nested object on each Confluence Cloud personal space; optional children may be absent from a valid response.
Self
Self
users.personalSpace._links.selfSelf. Full URL to the space API resource. It locates the provider resource or path associated with the Confluence Cloud space link.- Enables: Associate each Confluence Cloud space link with the resource identified by self in
users.ConfluenceCloudSpaceLinks.self; verify the link resolves to the expected Confluence Cloud object. - Interpretation: Confluence Cloud reports self as a resource locator for each Confluence Cloud space link; access still depends on viewer permissions and the URL may expire or change.
Webui
Webui
users.personalSpace._links.webuiWebui. Relative URL to the space in the Confluence web UI. It is needed to continue the provider result set without skipping or repeating a page.- Enables: Resume Confluence Cloud pagination from
users.ConfluenceCloudSpaceLinks.webuiand verify that every page boundary advances before requesting the next result set. - Interpretation: Confluence Cloud returns webui as opaque pagination state; it has no business meaning and must be replayed exactly when requesting the next page.
ID
ID
users.personalSpace.idID. Numeric ID of the personal space. It provides the reference needed to connect the user to the corresponding provider object.- Enables: Connect each Confluence Cloud personal space in Users to the referenced Confluence Cloud personal space through
users.ConfluenceCloudPersonalSpace.id; flag ID values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports ID as an identifier in its Confluence Cloud personal space namespace; it is not a universal identity outside Confluence Cloud.
Key
Key
users.personalSpace.keyKey. The space key, typically prefixed with ~ for personal spaces. It provides the reference needed to connect the user to the corresponding provider object.- Enables: Connect each Confluence Cloud personal space in Users to the referenced Confluence Cloud personal space through
users.ConfluenceCloudPersonalSpace.key; flag key values that do not resolve in that provider namespace. - Interpretation: Confluence Cloud reports key as an identifier in its Confluence Cloud personal space namespace; it is not a universal identity outside Confluence Cloud.
Name
Name
users.personalSpace.nameName. Display name of the personal space. It gives the Confluence Cloud personal space a human-readable provider label while its identifier remains the stable reference.- Enables: Label each Confluence Cloud personal space with name from
users.ConfluenceCloudPersonalSpace.name; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports name as display text for each Confluence Cloud personal space; names are mutable and are not stable identities.
Status
Status
users.personalSpace.statusStatus. Current status of the space, e.g. ‘current’ or ‘archived’. It identifies the related provider object that gives the Confluence Cloud personal space its parent, owner, or container context.- Enables: Segment Confluence Cloud personal space entries in Users by status in
users.ConfluenceCloudPersonalSpace.status; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports status as a label from its own taxonomy on each Confluence Cloud personal space; preserve unknown labels rather than mapping them by assumption.
Type
Type
users.personalSpace.typeType. Type of space, e.g. ‘personal’ or ‘global’. It identifies the related provider object that gives the Confluence Cloud personal space its parent, owner, or container context.- Enables: Segment Confluence Cloud personal space entries in Users by type in
users.ConfluenceCloudPersonalSpace.type; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports type as a label from its own taxonomy on each Confluence Cloud personal space; preserve unknown labels rather than mapping them by assumption.
Profile Picture
Profile Picture
users.profilePictureProfile Picture. Profile picture metadata for the user. It preserves the nested context needed to interpret the parent user.- Enables: Attribute profile picture in
users.profilePictureto the parent user; identify parent records where that nested profile picture object is absent. - Interpretation: Confluence Cloud reports profile picture as a nested object on each user; optional children may be absent from a valid response.
Height
Height
users.profilePicture.heightHeight. Height of the profile picture in pixels. It supplies the height measure for the Confluence Cloud profile picture at the provider’s declared unit and grain.- Enables: Measure height through
users.ConfluenceCloudProfilePicture.heightfor each Confluence Cloud profile picture and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports height as a measure on each Confluence Cloud profile picture; compare only records with the same unit and aggregation grain.
Is Default
Is Default
users.profilePicture.isDefaultIs Default. Whether this is the default/generated avatar rather than a user-uploaded image. It distinguishes the provider-defined is default state or classification for the Confluence Cloud profile picture.- Enables: Filter Users by whether this is the default/generated avatar rather than a user-uploaded image in
users.ConfluenceCloudProfilePicture.isDefault; count true, false, and missing results separately. - Interpretation: Confluence Cloud reports this is the default/generated avatar rather than a user-uploaded image as a boolean on each Confluence Cloud profile picture; a missing field is unknown, not false.
Path
Path
users.profilePicture.pathPath. Relative path to the profile picture resource. It locates the provider resource or path associated with the Confluence Cloud profile picture.- Enables: Resolve the user’s provider resource or path through
users.ConfluenceCloudProfilePicture.path; verify access separately and do not infer that linked content was ingested. - Interpretation: Confluence Cloud returns path as a resource locator or path for each Confluence Cloud profile picture; access can expire or depend on viewer permissions, and linked content is not implied.
Width
Width
users.profilePicture.widthWidth. Width of the profile picture in pixels. It supplies the width measure for the Confluence Cloud profile picture at the provider’s declared unit and grain.- Enables: Measure width through
users.ConfluenceCloudProfilePicture.widthfor each Confluence Cloud profile picture and compare only values with the same unit and record grain. - Interpretation: Confluence Cloud reports width as a measure on each Confluence Cloud profile picture; compare only records with the same unit and aggregation grain.
Public Name
Public Name
users.publicNamePublic Name. Display name of the user. Human-readable identifier for org overview reporting. It identifies the related provider object that gives the user its parent, owner, or container context.- Enables: Label each user with public name from
users.publicName; distinguish records that share that display name but have different Confluence Cloud identifiers. - Interpretation: Confluence Cloud reports public name as display text for each user; names are mutable and are not stable identities.
Type
Type
users.typeType. The object type identifier, typically ‘known’ for recognized users. It identifies the related provider object that gives the user its parent, owner, or container context.- Enables: Segment user entries in Users by type in
users.type; compare counts only within the same Confluence Cloud taxonomy. - Interpretation: Confluence Cloud reports type as a label from its own taxonomy on each user; preserve unknown labels rather than mapping them by assumption.
| Error | Meaning | Solution |
|---|---|---|
| 401 Unauthorized (API token) | Invalid credentials | Check email and API token |
| 401 on token exchange (OAuth) | Invalid client ID/secret or missing audience | Recreate credentials; include audience=api.atlassian.com |
| 403 Forbidden | Missing scope or Confluence permission | Check scopes and service account access |
| Empty space list | Wrong Cloud ID or no browse access | Verify Cloud ID; grant Confluence access |