Client library for Confluence
npm install --save @datafire/confluence
let confluence = require('@datafire/confluence').create({
username: "",
password: "",
host: ""
});
.then(data => {
console.log(data);
});
The Confluence Cloud REST API
Returns all records in the audit log, optionally for a certain date range. This contains information about events like space exports, group membership changes, app installations, etc. For more information, see Audit log in the Confluence administrator's guide.
confluence.audit.get({}, context)
- input
object
- endDate
string
: Filters the results to the records on or before the endDate. - limit
integer
: The maximum number of records to return per page. - searchString
string
: Filters the results to records that have string property values - start
integer
: The starting index of the returned records. - startDate
string
: Filters the results to the records on or after the startDate.
- endDate
Output schema unknown
Creates a record in the audit log.
confluence.audit.post({}, context)
- input
object
- body
object
- affectedObject
object
- associatedObjects
array
: Objects that were associated with the event. For example, if the event- items
object
- items
- author
object
: The user that actioned the event. If author is not specified, then all - category
string
: The category of the event, which is displayed in the 'Event type' column - changedValues
array
: The values that were changed in the event.- items
object
- items
- creationDate
integer
: The creation date-time of the audit record, as a timestamp. This is converted - description
string
: A long description of the event, which is displayed in the 'Description' - remoteAddress
string
: The IP address of the computer where the event was initiated from. - summary
string
: The summary of the event, which is displayed in the 'Change' column on - sysAdmin
boolean
: Indicates whether the event was actioned by a system administrator.
- affectedObject
- body
Output schema unknown
Exports audit records as a CSV file or ZIP file.
confluence.audit.export.get({}, context)
- input
object
- endDate
string
: Filters the exported results to the records on or before the endDate. - format
string
: The format of the export file for the audit records. - searchString
string
: Filters the exported results to records that have string property values - startDate
string
: Filters the exported results to the records on or after the startDate.
- endDate
Output schema unknown
Returns the retention period for records in the audit log. The retention period is how long an audit record is kept for, from creation date until it is deleted.
confluence.audit.retention.get(null, context)
This action has no parameters
Output schema unknown
Sets the retention period for records in the audit log. The retention period can be set to a maximum of 20 years.
confluence.audit.retention.put({}, context)
- input
object
- body
object
- number
integer
: The number of units for the retention period. - units
string
(values: NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS, DAYS, WEEKS, MONTHS): The unit of time that the retention period is measured in.
- number
- body
Output schema unknown
Returns records from the audit log, for a time period back from the current date. For example, you can use this method to get the last 3 months of records.
confluence.audit.since.get({}, context)
- input
object
- limit
integer
: The maximum number of records to return per page. - number
integer
: The number of units for the time period. - searchString
string
: Filters the results to records that have string property values - start
integer
: The starting index of the returned records. - units
string
: The unit of time that the time period is measured in.
- limit
Output schema unknown
Returns all content in a Confluence instance.
confluence.content.get({}, context)
- input
object
- expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the content to expand. - limit
integer
: The maximum number of content objects to return per page. - orderby
string
: Orders the content by a particular field. Specify the field and sort direction for - postingDay
string
: The posting date of the blog post to be returned. Required for - spaceKey
string
: The key of the space to be queried for its content. - start
integer
: The starting index of the returned content. - status
array
: Filter the results to a set of content based on their status. If set to any, - title
string
: The title of the page to be returned. Required for page type. - trigger
string
: If set to viewed, the request will trigger a 'viewed' event for the content. - type
string
: The type of content to return.
- expand
Output schema unknown
Creates a new piece of content or publishes an existing draft.
confluence.content.post({}, context)
- input
object
- body
object
- ancestors
array
: The parent content of the new content. Only one parent content- items
object
- items
- body
object
: The body of the new content. Does not apply to attachments. - id
string
: The ID of the draft content. Required when publishing a draft. - space
object
: The space that the content is being created in. - status
string
(values: current, trashed, historical, draft): The status of the new content. - title
string
- type
string
(values: page, blogpost, comment, attachment): The type of the new content. Custom content types defined by apps are also supported.
- ancestors
- expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content to expand. - status
string
: Filter the returned content by status.
- body
Output schema unknown
Moves a piece of content to the space's trash or purges it from the trash, depending on the content's type and status:
confluence.content.id.delete({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to be deleted. - status
string
: Set this to trashed, if the content's status is trashed and you want to purge it.
- id required
Output schema unknown
Returns a single piece of content, like a page or a blog post.
confluence.content.id.get({
"id": ""
}, context)
- input
object
- embeddedContentRender
string
: The version of embedded content (e.g. attachments) to render. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the content to expand. - id required
string
: The ID of the content to be returned. If you don't know the content ID, - status
array
: Filter the results to a set of content based on their status. - trigger
string
: If set to viewed, the request will trigger a 'viewed' event for the content. - version
integer
: The version number of the content to be returned.
- embeddedContentRender
Output schema unknown
Updates a piece of content. Use this method to update the title or body of a piece of content, change the status, change the parent page, and more.
confluence.content.id.put({
"id": ""
}, context)
- input
object
- body
object
- ancestors
array
: The new parent for the content. Only one parent content 'id' can be specified.- items
object
- items
- body
object
: The updated body of the content. Does not apply to attachments. - status
string
(values: current, trashed, historical, draft): The updated status of the content. Note, if you change the status of a page from - title
string
: The updated title of the content. If you are not changing this field, set this to the current title. - type
string
(values: page, blogpost, comment, attachment): The type of content. Set this to the current type of the content. - version
object
: The new version for the updated content. Set this to the current version number incremented by one, unless you are changing the status to 'draft' which must have a version number of 1.
- ancestors
- conflictPolicy
string
: The action that should be taken when conflicts are discovered. - id required
string
: The ID of the content to be updated. - status
string
: The updated status of the content. Use this parameter to change the
- body
Output schema unknown
Returns a map of the direct children of a piece of content. A piece of content has different types of child content, depending on its type. These are the default parent-child content type relationships:
confluence.content.id.child.get({
"id": ""
}, context)
- input
object
- expand
array
(values: attachment, comments, page): A multi-value parameter indicating which properties of the children to expand, where: - id required
string
: The ID of the content to be queried for its children. - parentVersion
integer
: The version of the parent content to retrieve children for.
- expand
Output schema unknown
Returns all children of a given type, for a piece of content. A piece of content has different types of child content, depending on its type:
confluence.content.id.child.type.get({
"id": "",
"type": ""
}, context)
- input
object
- expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content to expand. - id required
string
: The ID of the content to be queried for its children. - limit
integer
: The maximum number of content to return per page. Note, - parentVersion
integer
: The version of the parent content to retrieve children for. - start
integer
: The starting index of the returned content. - type required
string
: The type of children to return.
- expand
Output schema unknown
Returns the attachments for a piece of content.
confluence.content.id.child.attachment.get({
"id": ""
}, context)
- input
object
- expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the - filename
string
: Filter the results to attachments that match the filename. - id required
string
: The ID of the content to be queried for its attachments. - limit
integer
: The maximum number of attachments to return per page. - mediaType
string
: Filter the results to attachments that match the media type. - start
integer
: The starting index of the returned attachments.
- expand
Output schema unknown
Adds an attachment to a piece of content. This method only adds a new attachment. If you want to update an existing attachment, use Create or update attachments.
confluence.content.id.child.attachment.post({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to add the attachment to. - status
string
: The status of the content that the attachment is being added to.
- id required
Output schema unknown
Adds an attachment to a piece of content. If the attachment already exists for the content, then the attachment is updated (i.e. a new version of the attachment is created).
confluence.content.id.child.attachment.put({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to add the attachment to. - status
string
: The status of the content that the attachment is being added to.
- id required
Output schema unknown
Updates the attachment properties, i.e. the non-binary data of an attachment like the filename, media-type, comment, and parent container.
confluence.content.id.child.attachment.attachmentId.put({
"attachmentId": "",
"id": ""
}, context)
- input
object
- attachmentId required
string
: The ID of the attachment to update. - body
object
- container
object
: The new content to attach the attachment to. - id
string
: The ID of the attachment to be updated. - metadata
object
- title
string
: The updated name of the attachment. - type
string
(values: attachment): Set this to attachment. - version
object
: The attachment version. Set this to the current version number of the
- container
- id required
string
: The ID of the content that the attachment is attached to.
- attachmentId required
Output schema unknown
Updates the binary data of an attachment, given the attachment ID, and optionally the comment and the minor edit field.
confluence.content.id.child.attachment.attachmentId.data.post({
"attachmentId": "",
"id": ""
}, context)
- input
object
- attachmentId required
string
: The ID of the attachment to update. - id required
string
: The ID of the content that the attachment is attached to.
- attachmentId required
Output schema unknown
Returns the comments on a piece of content.
confluence.content.id.child.comment.get({
"id": ""
}, context)
- input
object
- depth
string
: Currently, this parameter is not used. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space, extensions.inlineProperties, extensions.resolution): A multi-value parameter indicating which properties of the - id required
string
: The ID of the content to be queried for its comments. - limit
integer
: The maximum number of comments to return per page. Note, - location
array
: The location of the comments in the page. Multiple locations can be specified. - parentVersion
integer
: The version of the parent content to retrieve children for. - start
integer
: The starting index of the returned comments.
- depth
Output schema unknown
Returns a map of the descendants of a piece of content. This is similar to Get content children, except that this method returns child pages at all levels, rather than just the direct child pages.
confluence.content.id.descendant.get({
"id": ""
}, context)
- input
object
- expand
array
(values: attachment, comments, page): A multi-value parameter indicating which properties of the children to - id required
string
: The ID of the content to be queried for its descendants.
- expand
Output schema unknown
Returns all descendants of a given type, for a piece of content. This is similar to Get content children by type, except that this method returns child pages at all levels, rather than just the direct child pages.
confluence.content.id.descendant.type.get({
"id": "",
"type": ""
}, context)
- input
object
- expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content to expand. - id required
string
: The ID of the content to be queried for its descendants. - limit
integer
: The maximum number of content to return per page. Note, - start
integer
: The starting index of the returned content. - type required
string
: The type of descendants to return.
- expand
Output schema unknown
Returns the most recent update for a piece of content.
confluence.content.id.history.get({
"id": ""
}, context)
- input
object
- expand
array
(values: lastUpdated, previousVersion, contributors, nextVersion): A multi-value parameter indicating which properties of the content history to expand. - id required
string
: The ID of the content to be queried for its history.
- expand
Output schema unknown
Returns the body of a macro in storage format, for the given macro ID. This includes information like the name of the macro, the body of the macro, and any macro parameters. This method is mainly used by Cloud apps.
confluence.content.id.history.version.macro.id.macroId.get({
"id": "",
"macroId": "",
"version": 0
}, context)
- input
object
- id required
string
: The ID for the content that contains the macro. - macroId required
string
: The ID of the macro. This is usually passed by the app that the - version required
integer
: The version of the content that contains the macro.
- id required
Output schema unknown
Removes a label from a piece of content. This is similar to Remove label from content except that the label name is specified via a query parameter.
confluence.content.id.label.delete({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content that the label will be removed from. - name
string
: The name of the label to be removed.
- id required
Output schema unknown
Returns the labels on a piece of content.
confluence.content.id.label.get({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to be queried for its labels. - limit
integer
: The maximum number of labels to return per page. Note, - prefix
string
(values: global, my, team): Filters the results to labels with the specified prefix. If this parameteris not specified, then labels with any prefix will be returned. - start
integer
: The starting index of the returned labels.
- id required
Output schema unknown
Adds labels to a piece of content. Does not modify the existing labels.
confluence.content.id.label.post({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content that will have labels added to it.
- id required
Output schema unknown
Removes a label from a piece of content. This is similar to Remove label from content using query parameter except that the label name is specified via a path parameter.
confluence.content.id.label.label.delete({
"id": "",
"label": ""
}, context)
- input
object
- id required
string
: The ID of the content that the label will be removed from. - label required
string
: The name of the label to be removed.
- id required
Output schema unknown
Returns the watches for a page. A user that watches a page will receive receive notifications when the page is updated.
confluence.content.id.notification.child_created.get({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to be queried for its watches. - limit
integer
: The maximum number of watches to return per page. - start
integer
: The starting index of the returned watches.
- id required
Output schema unknown
Returns all space watches for the space that the content is in. A user that watches a space will receive receive notifications when any content in the space is updated.
confluence.content.id.notification.created.get({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the content to be queried for its watches. - limit
integer
: The maximum number of watches to return per page. - start
integer
: The starting index of the returned watches.
- id required
Output schema unknown
Copy page hierarchy allows the copying of an entire hierarchy of pages and their associated properties, permissions and attachments. The id path parameter refers to the content id of the page to copy, and the new parent of this copied page is defined using the destinationPageId in the request body. The titleOptions object defines the rules of renaming page titles during the copy; for example, search and replace can be used in conjunction to rewrite the copied page titles.
confluence.content.id.pagehierarchy.copy.post({
"id": ""
}, context)
- input
object
- body
object
- copyAttachments
boolean
- copyLabels
boolean
- copyPermissions
boolean
- copyProperties
boolean
- destinationPageId
string
- originalPageId
string
- titleOptions
object
- copyAttachments
- id required
string
- body
Output schema unknown
Returns the properties for a piece of content. For more information about content properties, see Content properties in the REST API.
confluence.content.id.property.get({
"id": ""
}, context)
- input
object
- expand
array
(values: content, version): A multi-value parameter indicating which properties of the content to - id required
string
: The ID of the content to be queried for its properties. - limit
integer
: The maximum number of properties to return per page. - start
integer
: The starting index of the returned properties.
- expand
Output schema unknown
Creates a property for an existing piece of content. For more information about content properties, see Content properties in the REST API.
confluence.content.id.property.post({
"id": ""
}, context)
- input
object
- body
object
- key
string
: The key of the new property. - value
object
: The value of the property. This can be empty or a complex object.
- key
- id required
string
: The ID of the content to add the property to.
- body
Output schema unknown
Deletes a content property. For more information about content properties, see Content properties in the REST API.
confluence.content.id.property.key.delete({
"id": "",
"key": ""
}, context)
- input
object
- id required
string
: The ID of the content that the property belongs to. - key required
string
: The key of the property.
- id required
Output schema unknown
Returns a content property for a piece of content. For more information, see Content properties in the REST API.
confluence.content.id.property.key.get({
"id": "",
"key": ""
}, context)
- input
object
- expand
array
(values: content, version): A multi-value parameter indicating which properties of the content to - id required
string
: The ID of the content to be queried for the property. - key required
string
: The key of the content property.
- expand
Output schema unknown
Creates a property for an existing piece of content. For more information about content properties, see Content properties in the REST API.
confluence.content.id.property.key.post({
"id": "",
"key": ""
}, context)
- input
object
- body
object
- value
object
: The value of the property. This can be empty or a complex object.
- value
- id required
string
: The ID of the content to add the property to. - key required
string
: The key of the content property. Required.
- body
Output schema unknown
Updates an existing content property. This method will also create a new property for a piece of content, if the property key does not exist and the property version is 1. For more information about content properties, see Content properties in the REST API.
confluence.content.id.property.key.put({
"id": "",
"key": ""
}, context)
- input
object
- body
object
- value
object
: The value of the property. - version
object
: The version number of the property.
- value
- id required
string
: The ID of the content that the property belongs to. - key required
string
: The key of the property.
- body
Output schema unknown
Removes all restrictions (read and update) on a piece of content.
confluence.content.id.restriction.delete({
"id": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to remove restrictions from.
- expand
Output schema unknown
Returns the restrictions on a piece of content.
confluence.content.id.restriction.get({
"id": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to be queried for its restrictions. - limit
integer
: The maximum number of users and the maximum number of groups, in the - start
integer
: The starting index of the users and groups in the returned restrictions.
- expand
Output schema unknown
Adds restrictions to a piece of content. Note, this does not change any existing restrictions on the content.
confluence.content.id.restriction.post({
"id": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to add restrictions to.
- expand
Output schema unknown
Updates restrictions for a piece of content. This removes the existing restrictions and replaces them with the restrictions in the request.
confluence.content.id.restriction.put({
"id": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to update restrictions for.
- expand
Output schema unknown
Returns restrictions on a piece of content by operation. This method is similar to Get restrictions except that the operations are properties of the return object, rather than items in a results array.
confluence.content.id.restriction.byOperation.get({
"id": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to be queried for its restrictions.
- expand
Output schema unknown
Returns the restictions on a piece of content for a given operation (read or update).
confluence.content.id.restriction.byOperation.operationKey.get({
"id": "",
"operationKey": ""
}, context)
- input
object
- expand
array
(values: restrictions.user, restrictions.group, content): A multi-value parameter indicating which properties of the content - id required
string
: The ID of the content to be queried for its restrictions. - limit
integer
: The maximum number of users and the maximum number of groups, in the - operationKey required
string
: The operation type of the restrictions to be returned. - start
integer
: The starting index of the users and groups in the returned restrictions.
- expand
Output schema unknown
Removes a group from a content restriction. That is, remove read or update permission for the group for a piece of content.
confluence.content.id.restriction.byOperation.operationKey.group.groupName.delete({
"groupName": "",
"id": "",
"operationKey": ""
}, context)
- input
object
- groupName required
string
: The name of the group to remove from the content restriction. - id required
string
: The ID of the content that the restriction applies to. - operationKey required
string
: The operation that the restriction applies to.
- groupName required
Output schema unknown
Returns whether the specified content restriction applies to a group. For example, if the 'admins' group has permission to read a page with an ID of 123, then the following request will return true:
confluence.content.id.restriction.byOperation.operationKey.group.groupName.get({
"groupName": "",
"id": "",
"operationKey": ""
}, context)
- input
object
- groupName required
string
: The name of the group to be queried for whether the content restriction - id required
string
: The ID of the content that the restriction applies to. - operationKey required
string
: The operation that the restriction applies to.
- groupName required
Output schema unknown
Adds a group to a content restriction. That is, grant read or update permission to the group for a piece of content.
confluence.content.id.restriction.byOperation.operationKey.group.groupName.put({
"groupName": "",
"id": "",
"operationKey": ""
}, context)
- input
object
- groupName required
string
: The name of the group to add to the content restriction. - id required
string
: The ID of the content that the restriction applies to. - operationKey required
string
: The operation that the restriction applies to.
- groupName required
Output schema unknown
Removes a group from a content restriction. That is, remove read or update permission for the group for a piece of content.
confluence.content.id.restriction.byOperation.operationKey.user.delete({
"id": "",
"operationKey": ""
}, context)
- input
object
- accountId
string
: The account ID of the user to remove from the content restriction. - id required
string
: The ID of the content that the restriction applies to. - key
string
: The key of the user to remove from the content restriction. - operationKey required
string
: The operation that the restriction applies to. - userName
string
: The username of the user to remove from the content restriction.
- accountId
Output schema unknown
Returns whether the specified content restriction applies to a user. For example, if the user 'admin' has permission to read a page with an ID of 123, then the following request will return true:
confluence.content.id.restriction.byOperation.operationKey.user.get({
"id": "",
"operationKey": ""
}, context)
- input
object
- accountId
string
: The account ID of the user to be queried for whether the content - id required
string
: The ID of the content that the restriction applies to. - key
string
: The key of the user to be queried for whether the content - operationKey required
string
: The operation that is restricted. - userName
string
: The username of the user to be queried for whether the content
- accountId
Output schema unknown
Adds a user to a content restriction. That is, grant read or update permission to the user for a piece of content.
confluence.content.id.restriction.byOperation.operationKey.user.put({
"id": "",
"operationKey": ""
}, context)
- input
object
- accountId
string
: The account ID of the user to add to the content restriction. - id required
string
: The ID of the content that the restriction applies to. - key
string
: The key of the user to add to the content restriction. - operationKey required
string
: The operation that the restriction applies to. - userName
string
: The username of the user to add to the content restriction.
- accountId
Output schema unknown
Returns the versions for a piece of content in descending order.
confluence.content.id.version.get({
"id": ""
}, context)
- input
object
- expand
array
(values: collaborators, content): A multi-value parameter indicating which properties of the content to expand. - id required
string
: The ID of the content to be queried for its versions. - limit
integer
: The maximum number of versions to return per page. - start
integer
: The starting index of the returned versions.
- expand
Output schema unknown
Restores a historical version to be the latest version. That is, a new version is created with the content of the historical version.
confluence.content.id.version.post({
"id": ""
}, context)
- input
object
- body
object
- operationKey
string
(values: RESTORE): Set to 'RESTORE'. - params
object
- operationKey
- expand
array
(values: collaborators, content): A multi-value parameter indicating which properties of the returned - id required
string
: The ID of the content for which the history will be restored.
- body
Output schema unknown
Delete a historical version. This does not delete the changes made to the content in that version, rather the changes for the deleted version are rolled up into the next version. Note, you cannot delete the current version.
confluence.content.id.version.versionNumber.delete({
"id": "",
"versionNumber": 0
}, context)
- input
object
- id required
string
: The ID of the content that the version will be deleted from. - versionNumber required
integer
: The number of the version to be deleted. The version number starts
- id required
Output schema unknown
Returns a version for a piece of content.
confluence.content.id.version.versionNumber.get({
"id": "",
"versionNumber": 0
}, context)
- input
object
- expand
array
(values: collaborators, content): A multi-value parameter indicating which properties of the content to - id required
string
: The ID of the content to be queried for its version. - versionNumber required
integer
: The number of the version to be retrieved.
- expand
Output schema unknown
Publishes a legacy draft of a page created from a blueprint. Legacy drafts will eventually be removed in favour of shared drafts. For now, this method works the same as Publish shared draft.
confluence.content.blueprint.instance.draftId.post({
"draftId": ""
}, context)
- input
object
- body
object
- ancestors
array
: The new ancestor (i.e. parent page) for the content. If you have- items
object
- items
- space
object
: The space for the content. - status
string
(values: current): The status of the content. Set this to current or omit it altogether. - title
string
: The title of the content. If you don't want to change the title, - type
string
(values: page): The type of content. Set this to page. - version
object
: The version for the new content.
- ancestors
- draftId required
string
: The ID of the draft page that was created from a blueprint. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content - status
string
: The status of the content to be updated, i.e. the draft. This is set
- body
Output schema unknown
Publishes a shared draft of a page created from a blueprint.
confluence.content.blueprint.instance.draftId.put({
"draftId": ""
}, context)
- input
object
- body
object
- ancestors
array
: The new ancestor (i.e. parent page) for the content. If you have- items
object
- items
- space
object
: The space for the content. - status
string
(values: current): The status of the content. Set this to current or omit it altogether. - title
string
: The title of the content. If you don't want to change the title, - type
string
(values: page): The type of content. Set this to page. - version
object
: The version for the new content.
- ancestors
- draftId required
string
: The ID of the draft page that was created from a blueprint. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content - status
string
: The status of the content to be updated, i.e. the draft. This is set
- body
Output schema unknown
Returns the list of content that matches a Confluence Query Language (CQL) query. For information on CQL, see: Advanced searching using CQL.
confluence.content.search.get({}, context)
- input
object
- cql
string
: The CQL string that is used to find the requested content. - cqlcontext
string
(values: spaceKey, contentId, contentStatuses): The space, content, and content status to execute the search against. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the content to expand. - limit
integer
: The maximum number of content objects to return per page. - start
integer
: The starting index of the returned content.
- cql
Output schema unknown
Converts a content body from one format to another format.
confluence.contentbody.convert.to.post({
"to": ""
}, context)
- input
object
- body
object
- representation
string
(values: view, export_view, styled_view, storage, editor2, anonymous_export_view): The content format type. Set the value of this property to - value
string
: The body of the content in the relevant format.
- representation
- contentIdContext
string
: The content ID used to find the space for resolving embedded content - embeddedContentRender
string
(values: current, version-at-save): Mode used for rendering embedded content, like attachments. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the new content to expand. - spaceKeyContext
string
: The space key used for resolving embedded content (page includes, - to required
string
: The name of the target format for the content body.
- body
Output schema unknown
Returns all user groups. The returned groups are ordered alphabetically in ascending order by group name.
confluence.group.get({}, context)
- input
object
- limit
integer
: The maximum number of groups to return per page. - start
integer
: The starting index of the returned groups.
- limit
Output schema unknown
Returns a user group for a given group name.
confluence.group.groupName.get({
"groupName": ""
}, context)
- input
object
- groupName required
string
: The name of the group. This is the same as the group name shown in
- groupName required
Output schema unknown
Returns the users that are members of a group.
confluence.group.groupName.member.get({
"groupName": ""
}, context)
- input
object
- groupName required
string
: The name of the group to be queried for its members. - limit
integer
: The maximum number of users to return per page. - start
integer
: The starting index of the returned users.
- groupName required
Output schema unknown
Returns information about all active long-running tasks (e.g. space export), such as how long each task has been running and the percentage of each task that has completed.
confluence.longtask.get({}, context)
- input
object
- limit
integer
: The maximum number of tasks to return per page. Note, this may be - start
integer
: The starting index of the returned tasks.
- limit
Output schema unknown
Returns information about an active long-running task (e.g. space export), such as how long it has been running and the percentage of the task that has completed.
confluence.longtask.id.get({
"id": ""
}, context)
- input
object
- id required
string
: The ID of the task.
- id required
Output schema unknown
Returns all target entities that have a particular relationship to the source entity. Note, relationships are one way.
confluence.relation.relationName.from.sourceType.sourceKey.to.targetType.get({
"relationName": "",
"sourceKey": "",
"sourceType": "",
"targetType": ""
}, context)
- input
object
- expand
array
(values: relationData, source, target): A multi-value parameter indicating which properties of the response - limit
integer
: The maximum number of relationships to return per page. - relationName required
string
: The name of the relationship. This method supports relationships created via - sourceKey required
string
(values: sourceType): The identifier for the source entity: - sourceStatus
string
: The status of the source. This parameter is only used when the - sourceType required
string
: The source entity type of the relationship. - sourceVersion
integer
: The version of the source. This parameter is only used when the - start
integer
: The starting index of the returned relationships. - targetStatus
string
: The status of the target. This parameter is only used when the - targetType required
string
: The target entity type of the relationship. - targetVersion
integer
: The version of the target. This parameter is only used when the
- expand
Output schema unknown
Deletes a relationship between two entities (user, space, content).
confluence.relation.relationName.from.sourceType.sourceKey.to.targetType.targetKey.delete({
"relationName": "",
"sourceKey": "",
"sourceType": "",
"targetKey": "",
"targetType": ""
}, context)
- input
object
- relationName required
string
: The name of the relationship. - sourceKey required
string
(values: sourceType): The identifier for the source entity: - sourceStatus
string
: The status of the source. This parameter is only used when the - sourceType required
string
: The source entity type of the relationship. This must be 'user', if - sourceVersion
integer
: The version of the source. This parameter is only used when the - targetKey required
string
(values: sourceType): The identifier for the target entity: - targetStatus
string
: The status of the target. This parameter is only used when the - targetType required
string
: The target entity type of the relationship. This must be 'space' or - targetVersion
integer
: The version of the target. This parameter is only used when the
- relationName required
Output schema unknown
Find whether a particular type of relationship exists from a source entity to a target entity. Note, relationships are one way.
confluence.relation.relationName.from.sourceType.sourceKey.to.targetType.targetKey.get({
"relationName": "",
"sourceKey": "",
"sourceType": "",
"targetKey": "",
"targetType": ""
}, context)
- input
object
- expand
array
(values: relationData, source, target): A multi-value parameter indicating which properties of the response - relationName required
string
: The name of the relationship. This method supports the 'favourite' - sourceKey required
string
(values: sourceType): The identifier for the source entity: - sourceStatus
string
: The status of the source. This parameter is only used when the - sourceType required
string
: The source entity type of the relationship. This must be 'user', if - sourceVersion
integer
: The version of the source. This parameter is only used when the - targetKey required
string
(values: sourceType): The identifier for the target entity: - targetStatus
string
: The status of the target. This parameter is only used when the - targetType required
string
: The target entity type of the relationship. This must be 'space' or - targetVersion
integer
: The version of the target. This parameter is only used when the
- expand
Output schema unknown
Creates a relationship between two entities (user, space, content). The 'favourite' relationship is supported by default, but you can use this method to create any type of relationship between two entities.
confluence.relation.relationName.from.sourceType.sourceKey.to.targetType.targetKey.put({
"relationName": "",
"sourceKey": "",
"sourceType": "",
"targetKey": "",
"targetType": ""
}, context)
- input
object
- relationName required
string
: The name of the relationship. This method supports the 'favourite' - sourceKey required
string
(values: sourceType): The identifier for the source entity: - sourceStatus
string
: The status of the source. This parameter is only used when the - sourceType required
string
: The source entity type of the relationship. This must be 'user', if - sourceVersion
integer
: The version of the source. This parameter is only used when the - targetKey required
string
(values: sourceType): The identifier for the target entity: - targetStatus
string
: The status of the target. This parameter is only used when the - targetType required
string
: The target entity type of the relationship. This must be 'space' or - targetVersion
integer
: The version of the target. This parameter is only used when the
- relationName required
Output schema unknown
Returns all target entities that have a particular relationship to the source entity. Note, relationships are one way.
confluence.relation.relationName.to.targetType.targetKey.from.sourceType.get({
"relationName": "",
"sourceType": "",
"targetKey": "",
"targetType": ""
}, context)
- input
object
- expand
array
(values: relationData, source, target): A multi-value parameter indicating which properties of the response - limit
integer
: The maximum number of relationships to return per page. - relationName required
string
: The name of the relationship. This method supports relationships created via - sourceStatus
string
: The status of the source. This parameter is only used when the - sourceType required
string
: The source entity type of the relationship. - sourceVersion
integer
: The version of the source. This parameter is only used when the - start
integer
: The starting index of the returned relationships. - targetKey required
string
(values: sourceType): The identifier for the target entity: - targetStatus
string
: The status of the target. This parameter is only used when the - targetType required
string
: The target entity type of the relationship. - targetVersion
integer
: The version of the target. This parameter is only used when the
- expand
Output schema unknown
Searches for content using the Confluence Query Language (CQL)
confluence.search.get({}, context)
- input
object
- cql
string
: The CQL query to be used for the search. See - cqlcontext
string
(values: spaceKey, contentId, contentStatuses): The space, content, and content status to execute the search - includeArchivedSpaces
boolean
: Include content from archived spaces in the results. - limit
integer
: The maximum number of content objects to return per page. - start
integer
: The starting index of the returned content.
- cql
Output schema unknown
Returns the look and feel settings for the site or a single space. This includes attributes such as the color scheme, padding, and border radius.
confluence.settings.lookandfeel.get({}, context)
- input
object
- spaceKey
string
: The key of the space for which the look and feel settings will be
- spaceKey
Output schema unknown
Resets the custom look and feel settings for the site or a single space. This changes the values of the custom settings to be the same as the default settings. It does not change which settings (default or custom) are selected. Note, the default space settings are inherited from the current global settings.
confluence.settings.lookandfeel.custom.delete({}, context)
- input
object
- spaceKey
string
: The key of the space for which the look and feel settings will be
- spaceKey
Output schema unknown
Updates the look and feel settings for the site or for a single space. If custom settings exist, they are updated. If no custom settings exist, then a set of custom settings is created.
confluence.settings.lookandfeel.custom.post({}, context)
- input
object
- body
object
- bordersAndDividers
object
- content
object
- header
object
- headings
object
- links
object
- menus
object
- bordersAndDividers
- spaceKey
string
: The key of the space for which the look and feel settings will be
- body
Output schema unknown
Sets the look and feel settings to either the default settings or the custom settings, for the site or a single space. Note, the default space settings are inherited from the current global settings.
confluence.settings.lookandfeel.selected.put({}, context)
- input
object
- body
object
- custom
object
- global
object
- selected
string
(values: global, custom): The look and feel scheme. If you set this to global, you must specify
- custom
- spaceKey
string
: The key of the space for which the look and feel settings will be
- body
Output schema unknown
Returns the system information for the Confluence Cloud tenant. This information is used by Atlassian.
confluence.settings.systemInfo.get(null, context)
This action has no parameters
Output schema unknown
Returns all themes, not including the default theme.
confluence.settings.theme.get({}, context)
- input
object
- limit
integer
: The maximum number of themes to return per page. - start
integer
: The starting index of the returned themes.
- limit
Output schema unknown
Returns a theme. This includes information about the theme name, description, and icon.
confluence.settings.theme.themeKey.get({
"themeKey": ""
}, context)
- input
object
- themeKey required
string
: The key of the theme to be returned.
- themeKey required
Output schema unknown
Returns the globally assigned theme.
confluence.settings.theme.selected.get(null, context)
This action has no parameters
Output schema unknown
Returns all spaces. The returned spaces are ordered alphabetically in ascending order by space key.
confluence.space.get({}, context)
- input
object
- expand
array
(values: settings, metadata.labels, operations, lookAndFeel, permissions, icon, description.plain, description.view, theme, homepage): A multi-value parameter indicating which properties of the spaces to - favourite
boolean
: Filter the results to the favourite spaces of the user specified by - favouriteUserKey
string
: The userKey of the user, whose favourite spaces are used to filter - label
array
: Filter the results to spaces based on their label. - limit
integer
: The maximum number of spaces to return per page. Note, this may be - spaceKey
array
: The key of the space to be returned. To return multiple spaces, - start
integer
: The starting index of the returned spaces. - status
string
: Filter the results to spaces based on their status. - type
string
: Filter the results to spaces based on their type.
- expand
Output schema unknown
Creates a new space. Note, currently you cannot set space labels when creating a space.
confluence.space.post({}, context)
- input
object
- body
object
- description
object
: The description of the new/updated space. Note, only the 'plain' representation - key
string
: The key for the new space. Format: See Space - name
string
: The name of the new space. - permissions
array
: The permissions for the new space. If no permissions are provided, the- items
object
- items
- description
- body
Output schema unknown
Creates a new space that is only visible to the creator. This method is the same as the Create space method with permissions set to the current user only. Note, currently you cannot set space labels when creating a space.
confluence.space._private.post({}, context)
- input
object
- body
object
- description
object
: The description of the new/updated space. Note, only the 'plain' representation - key
string
: The key for the new space. Format: See Space - name
string
: The name of the new space.
- description
- body
Output schema unknown
Deletes a space. Note, the space will be deleted in a long running task. Therefore, the space may not be deleted yet when this method has returned. Clients should poll the status link that is returned in the response until the task completes.
confluence.space.spaceKey.delete({
"spaceKey": ""
}, context)
- input
object
- spaceKey required
string
: The key of the space to delete.
- spaceKey required
Output schema unknown
Returns a space. This includes information like the name, description, and permissions, but not the content in the space.
confluence.space.spaceKey.get({
"spaceKey": ""
}, context)
- input
object
- expand
array
(values: settings, metadata.labels, operations, lookAndFeel, permissions, icon, description.plain, description.view, theme, homepage): A multi-value parameter indicating which properties of the space to - spaceKey required
string
: The key of the space to be returned.
- expand
Output schema unknown
Updates the name, description, or homepage of a space.
confluence.space.spaceKey.put({
"spaceKey": ""
}, context)
- input
object
- body
object
- description
object
: The description of the new/updated space. Note, only the 'plain' representation - homepage
object
: The page to set as the homepage of the space. - name
string
: The name of the space.
- description
- spaceKey required
string
: The key of the space to update.
- body
Output schema unknown
Returns all content in a space. The returned content is grouped by type (pages then blogposts), then ordered by content ID in ascending order.
confluence.space.spaceKey.content.get({
"spaceKey": ""
}, context)
- input
object
- depth
string
: Filter the results to content at the root level of the space or all content. - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the content - limit
integer
: The maximum number of content objects to return per page. Note, this - spaceKey required
string
: The key of the space to be queried for its content. - start
integer
: The starting index of the returned content.
- depth
Output schema unknown
Returns all content of a given type, in a space. The returned content is ordered by content ID in ascending order.
confluence.space.spaceKey.content.type.get({
"spaceKey": "",
"type": ""
}, context)
- input
object
- depth
string
: Filter the results to content at the root level of the space or all - expand
array
(values: childTypes.all, childTypes.attachment, childTypes.comment, childTypes.page, container, metadata.currentuser, metadata.properties, metadata.labels, metadata.frontend, operations, children.page, children.attachment, children.comment, restrictions.read.restrictions.user, restrictions.read.restrictions.group, restrictions.update.restrictions.user, restrictions.update.restrictions.group, history, history.lastUpdated, history.previousVersion, history.contributors, history.nextVersion, ancestors, body, version, descendants.page, descendants.attachment, descendants.comment, space): A multi-value parameter indicating which properties of the content - limit
integer
: The maximum number of content objects to return per page. Note, this - spaceKey required
string
: The key of the space to be queried for its content. - start
integer
: The starting index of the returned content. - type required
string
: The type of content to return.
- depth
Output schema unknown
Returns all properties for the given space. Space properties are a key-value storage associated with a space.
confluence.space.spaceKey.property.get({
"spaceKey": ""
}, context)
- input
object
- expand
array
(values: version, space): A multi-value parameter indicating which properties of the space - limit
integer
: The maximum number of properties to return per page. Note, this may be - spaceKey required
string
: The key of the space to be queried for its properties. - start
integer
: The starting index of the returned objects.
- expand
Output schema unknown
Creates a new space property.
confluence.space.spaceKey.property.post({
"spaceKey": ""
}, context)
- input
object
- body
object
- key
string
: The key of the new property. - value
object
: The value of the property. This can be empty or a complex object.
- key
- spaceKey required
string
: The key of the space that the property will be created in.
- body
Output schema unknown
Deletes a space property.
confluence.space.spaceKey.property.key.delete({
"key": "",
"spaceKey": ""
}, context)
- input
object
- key required
string
: The key of the property to be deleted. - spaceKey required
string
: The key of the space that the property is in.
- key required
Output schema unknown
Returns a space property.
confluence.space.spaceKey.property.key.get({
"key": "",
"spaceKey": ""
}, context)
- input
object
- expand
array
(values: version, space): A multi-value parameter indicating which properties of the space - key required
string
: The key of the space property. - spaceKey required
string
: The key of the space that the property is in.
- expand
Output schema unknown
Creates a new space property. This is the same as POST /space/{spaceKey}/property but the key for the property is passed as a path parameter, rather than in the request body.
confluence.space.spaceKey.property.key.post({
"key": "",
"spaceKey": ""
}, context)
- input
object
- body
object
- value
object
: The value of the property. This can be empty or a complex object.
- value
- key required
string
: The key of the property to be created. - spaceKey required
string
: The key of the space that the property will be created in.
- body
Output schema unknown
Updates a space property. Note, you cannot update the key of a space property, only the value.
confluence.space.spaceKey.property.key.put({
"key": "",
"spaceKey": ""
}, context)
- input
object
- body
object
- value
object
: The value of the property. - version
object
: The version number of the property.
- value
- key required
string
: The key of the property to be updated. - spaceKey required
string
: The key of the space that the property is in.
- body
Output schema unknown
Returns the settings of a space. Currently only the routeOverrideEnabled setting can be returned.
confluence.space.spaceKey.settings.get({
"spaceKey": ""
}, context)
- input
object
- spaceKey required
string
: The key of the space to be queried for its settings.
- spaceKey required
Output schema unknown
Updates the settings for a space. Currently only the routeOverrideEnabled setting can be updated.
confluence.space.spaceKey.settings.put({
"spaceKey": ""
}, context)
- input
object
- body
object
- routeOverrideEnabled
boolean
: Defines whether an override for the space home should be used. This is
- routeOverrideEnabled
- spaceKey required
string
: The key of the space whose settings will be updated.
- body
Output schema unknown
Resets the space theme. This means that the space will inherit the global look and feel settings
confluence.space.spaceKey.theme.delete({
"spaceKey": ""
}, context)
- input
object
- spaceKey required
string
: The key of the space to reset the theme for.
- spaceKey required
Output schema unknown
Returns the theme selected for a space, if one is set. If no space theme is set, this means that the space is inheriting the global look and feel settings.
confluence.space.spaceKey.theme.get({
"spaceKey": ""
}, context)
- input
object
- spaceKey required
string
: The key of the space to be queried for its theme.
- spaceKey required
Output schema unknown
Sets the theme for a space. Note, if you want to reset the space theme to the default Confluence theme, use the 'Reset space theme' method instead of this method.
confluence.space.spaceKey.theme.put({
"spaceKey": ""
}, context)
- input
object
- body
object
- themeKey
string
: The key of the theme to be set as the space theme.
- themeKey
- spaceKey required
string
: The key of the space to set the theme for.
- body
Output schema unknown
Creates a new content template. Note, blueprint templates cannot be created via the REST API.
confluence.template.post({}, context)
- input
object
- body
object
- body
object
: This object is used when creating or updating content. - description
string
: A description of the new template. - labels
array
: Labels for the new template.- items
object
- items
- name
string
: The name of the new template. - space
object
: The key for the space of the new template. Only applies to space templates. - templateType
string
: The type of the new template. Set to page.
- body
- body
Output schema unknown
Updates a content template. Note, blueprint templates cannot be updated via the REST API.
confluence.template.put({}, context)
- input
object
- body
object
- body
object
: This object is used when creating or updating content. - description
string
: A description of the template. - labels
array
: Labels for the template.- items
object
- items
- name
string
: The name of the template. Set to the current name if this field is - space
object
: The key for the space of the template. Required if the template is a - templateId
string
: The ID of the template being updated. - templateType
string
(values: page): The type of the template. Set to page.
- body
- body
Output schema unknown
Deletes a template. This results in different actions depending on the type of template:
confluence.template.contentTemplateId.delete({
"contentTemplateId": ""
}, context)
- input
object
- contentTemplateId required
string
: The ID of the template to be deleted.
- contentTemplateId required
Output schema unknown
Returns a content template. This includes information about template, like the name, the space or blueprint that the template is in, the body of the template, and more.
confluence.template.contentTemplateId.get({
"contentTemplateId": ""
}, context)
- input
object
- contentTemplateId required
string
: The ID of the content template to be returned.
- contentTemplateId required
Output schema unknown
Returns all templates provided by blueprints. Use this method to retrieve all global blueprint templates or all blueprint templates in a space.
confluence.template.blueprint.get({}, context)
- input
object
- expand
array
(values: body): A multi-value parameter indicating which properties of the template - limit
integer
: The maximum number of templates to return per page. - spaceKey
string
: The key of the space to be queried for templates. If the spaceKey - start
integer
: The starting index of the returned templates.
- expand
Output schema unknown
Returns all content templates. Use this method to retrieve all global content templates or all content templates in a space.
confluence.template.page.get({}, context)
- input
object
- expand
array
(values: body): A multi-value parameter indicating which properties of the template - limit
integer
: The maximum number of templates to return per page. - spaceKey
string
: The key of the space to be queried for templates. If the spaceKey - start
integer
: The starting index of the returned templates.
- expand
Output schema unknown
Returns a user. This includes information about the user, like the display name, userKey, account ID, profile picture, and more.
confluence.user.get({}, context)
- input
object
- accountId
string
: The accountId of the user to be returned. Required, unless the - expand
array
(values: operations, details.personal, details.business): A multi-value parameter indicating which properties of the user to - key
string
: The userKey of the user to be returned. Required, unless the - username
string
: The username of the user to be returned. Required, unless the key
- accountId
Output schema unknown
Returns information about how anonymous users are represented, like the profile picture and display name.
confluence.user.anonymous.get({}, context)
- input
object
- expand
array
(values: operations): A multi-value parameter indicating which properties of the user to
- expand
Output schema unknown
Returns the currently logged-in user. This includes information about the user, like the display name, userKey, account ID, profile picture, and more.
confluence.user.current.get({}, context)
- input
object
- expand
array
(values: operations, details.personal, details.business): A multi-value parameter indicating which properties of the user to
- expand
Output schema unknown
Returns the groups that a user is a member of.
confluence.user.memberof.get({}, context)
- input
object
- accountId
string
: The accountId of the user to be queried. Required, unless the - key
string
: The userKey of the user to be queried. Required, unless the - limit
integer
: The maximum number of groups to return per page. - start
integer
: The starting index of the returned groups. - username
string
: The username of the user to be queried. Required, unless the key
- accountId
Output schema unknown
Removes a user as a watcher from a piece of content. Choose the user by doing one of the following:
confluence.user.watch.content.contentId.delete({
"contentId": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be removed as a watcher. Only one of - contentId required
string
: The ID of the content to remove the watcher from. - key
string
: The key of the user that will be removed as a watcher. Only one of - username
string
: The username of the user that will be removed as a watcher. Only one of
- accountId
Output schema unknown
Returns whether a user is watching a piece of content. Choose the user by doing one of the following:
confluence.user.watch.content.contentId.get({
"contentId": ""
}, context)
- input
object
- accountId
string
: The accountId of the user to be queried for whether they are watching - contentId required
string
: The ID of the content to be queried for whether the specified user is - key
string
: The key of the user to be queried for whether they are watching the - username
string
: The username of the user to be queried for whether they are watching
- accountId
Output schema unknown
Adds a user as a watcher to a piece of content. Choose the user by doing one of the following:
confluence.user.watch.content.contentId.post({
"contentId": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be added as a watcher. Only one - contentId required
string
: The ID of the content to add the watcher to. - key
string
: The key of the user that will be added as a watcher. Only one of - username
string
: The username of the user that will be added as a watcher. Only one
- accountId
Output schema unknown
Removes a user as a watcher from a label. Choose the user by doing one of the following:
confluence.user.watch.label.labelName.delete({
"labelName": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be removed as a watcher. Only one of - key
string
: The key of the user that will be removed as a watcher. Only one of - labelName required
string
: The name of the label to remove the watcher from. - username
string
: The username of the user that will be removed as a watcher. Only one of
- accountId
Output schema unknown
Returns whether a user is watching a label. Choose the user by doing one of the following:
confluence.user.watch.label.labelName.get({
"labelName": ""
}, context)
- input
object
- accountId
string
: The accountId of the user to be queried for whether they are watching - key
string
: The key of the user to be queried for whether they are watching the - labelName required
string
: The name of the label to be queried for whether the specified user is - username
string
: The username of the user to be queried for whether they are watching
- accountId
Output schema unknown
Adds a user as a watcher to a label. Choose the user by doing one of the following:
confluence.user.watch.label.labelName.post({
"labelName": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be added as a watcher. Only one - key
string
: The key of the user that will be added as a watcher. Only one of - labelName required
string
: The name of the label to add the watcher to. - username
string
: The username of the user that will be added as a watcher. Only one
- accountId
Output schema unknown
Removes a user as a watcher from a space. Choose the user by doing one of the following:
confluence.user.watch.space.spaceKey.delete({
"spaceKey": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be removed as a watcher. Only one of - key
string
: The key of the user that will be removed as a watcher. Only one of - spaceKey required
string
: The key of the space to remove the watcher from. - username
string
: The username of the user that will be removed as a watcher. Only one of
- accountId
Output schema unknown
Returns whether a user is watching a space. Choose the user by doing one of the following:
confluence.user.watch.space.spaceKey.get({
"spaceKey": ""
}, context)
- input
object
- accountId
string
: The accountId of the user to be queried for whether they are watching - key
string
: The key of the user to be queried for whether they are watching the - spaceKey required
string
: The key of the space to be queried for whether the specified user is - username
string
: The username of the user to be queried for whether they are watching
- accountId
Output schema unknown
Adds a user as a watcher to a space. Choose the user by doing one of the following:
confluence.user.watch.space.spaceKey.post({
"spaceKey": ""
}, context)
- input
object
- accountId
string
: The accountId of the user that will be added as a watcher. Only one - key
string
: The key of the user that will be added as a watcher. Only one of - spaceKey required
string
: The key of the space to add the watcher to. - username
string
: The username of the user that will be added as a watcher. Only one
- accountId
Output schema unknown
This integration has no definitions