Package io.github.primelib.confluence4j.rest.v1.api

Klasse ConfluenceRESTV1AsyncConsumerApi

java.lang.Object
io.github.primelib.confluence4j.rest.v1.api.ConfluenceRESTV1AsyncConsumerApi
@Generated("io.github.primelib.primecodegen.javafeign.JavaFeignGenerator") public class ConfluenceRESTV1AsyncConsumerApi extends Object

  • Konstruktordetails

  • Methodendetails

    • addContentWatcher

      public CompletableFuture<Void> addContentWatcher(Consumer<AddContentWatcherOperationSpec> spec)
      Add content watcher

      Adds a user as a watcher to a piece of content. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentId: The ID of the content to add the watcher to.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • addCustomContentPermissions

      public CompletableFuture<Void> addCustomContentPermissions(Consumer<AddCustomContentPermissionsOperationSpec> spec)
      Add new custom content permission to space

      Adds new custom content permission to space. If the permission to be added is a group permission, the group can be identified by its group name or group id. Note: Only apps can access this REST resource and only make changes to the respective app permissions. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [read:space.permission:confluence, write:space.permission:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content.
      • body: The permissions to be created.

    • addGroupToContentRestriction

      @Deprecated public CompletableFuture<Void> addGroupToContentRestriction(Consumer<AddGroupToContentRestrictionOperationSpec> spec)
      Veraltet.
      Add group to content restriction

      Deprecated, use [Add group to content restriction via groupId](https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-restrictions/#api-wiki-rest-api-content-id-restriction-byoperation-operationkey-bygroupid-groupid-put). Adds a group to a content restriction. That is, grant read or update permission to the group for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupName: The name of the group to add to the content restriction.

    • addGroupToContentRestrictionByGroupId

      public CompletableFuture<Void> addGroupToContentRestrictionByGroupId(Consumer<AddGroupToContentRestrictionByGroupIdOperationSpec> spec)
      Add group to content restriction

      Adds a group to a content restriction by Group Id. That is, grant read or update permission to the group for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupId: The groupId of the group to add to the content restriction.

    • addLabelWatcher

      public CompletableFuture<Void> addLabelWatcher(Consumer<AddLabelWatcherOperationSpec> spec)
      Add label watcher

      Adds a user as a watcher to a label. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • xAtlassianToken: Note, you must add header when making a request, as this operation has XSRF protection.
      • labelName: The name of the label to add the watcher to.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • addLabelsToContent

      public CompletableFuture<LabelArray> addLabelsToContent(Consumer<AddLabelsToContentOperationSpec> spec)
      Add labels to content

      Adds labels to a piece of content. Does not modify the existing labels. Notes: - Labels can also be added when creating content ([Create content](#api-content-post)). - Labels can be updated when updating content ([Update content](#api-content-id-put)). This will delete the existing labels and replace them with the labels in the request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that will have labels added to it.
      • body: The labels to add to the content.

    • addLabelsToSpace

      public CompletableFuture<LabelArray> addLabelsToSpace(Consumer<AddLabelsToSpaceOperationSpec> spec)
      Add labels to a space

      Adds labels to a piece of content. Does not modify the existing labels. Notes: - Labels can also be added when creating content ([Create content](#api-content-post)). - Labels can be updated when updating content ([Update content](#api-content-id-put)). This will delete the existing labels and replace them with the labels in the request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to add labels to.
      • labelCreate: The labels to add to the content.

    • addPermissionToSpace

      public CompletableFuture<SpacePermissionV2> addPermissionToSpace(Consumer<AddPermissionToSpaceOperationSpec> spec)
      Add new permission to space

      Adds new permission to space. If the permission to be added is a group permission, the group can be identified by its group name or group id. Note: Apps cannot access this REST resource - including when utilizing user impersonation. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [read:space.permission:confluence, write:space.permission:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content.
      • body: The permission to be created.

    • addRestrictions

      public CompletableFuture<ContentRestrictionArray> addRestrictions(Consumer<AddRestrictionsOperationSpec> spec)
      Add restrictions

      Adds restrictions to a piece of content. Note, this does not change any existing restrictions on the content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to add restrictions to.
      • body: The restrictions to be added to the content.
      • expand: A multi-value parameter indicating which properties of the content restrictions (returned in response) to expand. - restrictions.user returns the piece of content that the restrictions are applied to. Expanded by default. - restrictions.group returns the piece of content that the restrictions are applied to. Expanded by default. - content returns the piece of content that the restrictions are applied to.

    • addSpaceWatcher

      public CompletableFuture<Void> addSpaceWatcher(Consumer<AddSpaceWatcherOperationSpec> spec)
      Add space watcher

      Adds a user as a watcher to a space. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • xAtlassianToken: Note, you must add header when making a request, as this operation has XSRF protection.
      • spaceKey: The key of the space to add the watcher to.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • addUserToContentRestriction

      public CompletableFuture<Void> addUserToContentRestriction(Consumer<AddUserToContentRestrictionOperationSpec> spec)
      Add user to content restriction

      Adds a user to a content restriction. That is, grant read or update permission to the user for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • addUserToGroup

      @Deprecated public CompletableFuture<Void> addUserToGroup(Consumer<AddUserToGroupOperationSpec> spec)
      Veraltet.
      Add member to group

      Adds a user as a member in a group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: Name of the group whose membership is updated
      • body: AccountId of the user who needs to be added as member.

    • addUserToGroupByGroupId

      public CompletableFuture<Void> addUserToGroupByGroupId(Consumer<AddUserToGroupByGroupIdOperationSpec> spec)
      Add member to group by groupId

      Adds a user as a member in a group represented by its groupId **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: GroupId of the group whose membership is updated
      • body: AccountId of the user who needs to be added as member.

    • archivePages

      public CompletableFuture<LongTask> archivePages(Consumer<ArchivePagesOperationSpec> spec)
      Archive pages

      Archives a list of pages. The pages to be archived are specified as a list of content IDs. This API accepts the archival request and returns a task ID. The archival process happens asynchronously. Use the /longtask/&lt;taskId&gt; REST API to get the copy task status. Each content ID needs to resolve to page objects that are not already in an archived state. The content IDs need not belong to the same space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Archive' permission for each of the pages in the corresponding space it belongs to. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • archivePagesRequest: The pages to be archived.

    • asyncConvertContentBodyRequest

      public CompletableFuture<AsyncId> asyncConvertContentBodyRequest(Consumer<AsyncConvertContentBodyRequestOperationSpec> spec)
      Asynchronously convert content body

      Converts a content body from one format to another format asynchronously. Returns the asyncId for the asynchronous task. Supported conversions: - storage: export_view No other conversions are supported at the moment. Once a conversion is completed, it will be available for 5 minutes at the result endpoint. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: If request specifies 'contentIdContext', 'View' permission for the space, and permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • to: The name of the target format for the content body.
      • body: The content body to convert.
      • expand: A multi-value parameter indicating which properties of the content to expand and populate. Expands are dependent on the to conversion format and may be irrelevant for certain conversions (e.g. macroRenderedOutput is redundant when converting to view format). If rendering to view format, and the body content being converted includes arbitrary nested content (such as macros); then it is necessary to include webresource expands in the request. Webresources for content body are the batched JS and CSS dependencies for any nested dynamic content (i.e. macros). - embeddedContent returns metadata for nested content (e.g. page included using page include macro) - mediaToken returns JWT token for retrieving attachment data from Media API - macroRenderedOutput additionally converts body to view format - webresource.superbatch.uris.js returns all common JS dependencies as static URLs - webresource.superbatch.uris.css returns all common CSS dependencies as static URLs - webresource.superbatch.uris.all returns all common dependencies as static URLs - webresource.superbatch.tags.all returns all common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.superbatch.tags.css returns all common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.superbatch.tags.js returns all common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags - webresource.uris.js returns JS dependencies specific to conversion - webresource.uris.css returns CSS dependencies specific to conversion - webresource.uris.all returns all dependencies specific to conversion - webresource.tags.all returns common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.tags.css returns common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.tags.js returns common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags
      • spaceKeyContext: The space key used for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the spaceKeyContext=TEST parameter is provided, then the link will be converted to a link to the "Example page" page in the "TEST" space.
      • contentIdContext: The content ID used to find the space for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the contentIdContext=123 parameter is provided, then the link will be converted to a link to the "Example page" page in the same space that has the content with ID=123. Note, spaceKeyContext will be ignored if this parameter is provided.
      • allowCache: If this field is false, the cache will erase its current value and begin a new conversion. If this field is true, the cache will not erase its current value, and will set the status of the async conversion to RERUNNING. Once the data is updated, the status will change to COMPLETED. Large macros that take long to convert, and whose data need not immediately up to date (same as previous conversion's result within last 5 minutes) should set this fields to true. Cache values are stored per user per content body and expansions.
      • embeddedContentRender: Mode used for rendering embedded content, like attachments. - current renders the embedded content using the latest version. - version-at-save renders the embedded content using the version at the time of save.

    • asyncConvertContentBodyResponse

      public CompletableFuture<AsyncContentBody> asyncConvertContentBodyResponse(Consumer<AsyncConvertContentBodyResponseOperationSpec> spec)
      Get asynchronously converted content body from the id or the current status of the task.

      Returns the asynchronous content body for the corresponding id if the task is complete or returns the status of the task. After the task is completed, the result can be obtained for 5 minutes, or until an identical conversion request is made again, with allowCache query param set to false. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: If request specifies 'contentIdContext', 'View' permission for the space, and permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The asyncId of the macro task to get the converted body.

    • bulkRemoveContentStates

      public CompletableFuture<AsyncId> bulkRemoveContentStates(Consumer<BulkRemoveContentStatesOperationSpec> spec)
      Bulk remove content states from content

      Creates a long running task that Removes content state from draft or published versions of pages specified. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required** Content Edit Permission for a content to have its state removed via this endpoint. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • status: Set status to one of [current,draft].
      • bulkRemoveContentStatesRequest:

    • bulkSetContentStates

      public CompletableFuture<AsyncId> bulkSetContentStates(Consumer<BulkSetContentStatesOperationSpec> spec)
      Bulk set content state of many contents

      Creates a long running task that sets content state of draft or published versions of pages specified. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required** Content Edit Permission for a content to have its state set via this endpoint. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • status: Set status to one of [current,draft].
      • bulkContentStateSetInput: The content state and ids to set it to.

    • checkContentPermission

      public CompletableFuture<PermissionCheckResponse> checkContentPermission(Consumer<CheckContentPermissionOperationSpec> spec)
      Check content permissions

      Check if a user or a group can perform an operation to the specified content. The operation to check must be provided. The user’s account ID or the ID of the group can be provided in the subject to check permissions against a specified user or group. The following permission checks are done to make sure that the user or group has the proper access: - site permissions - space permissions - content restrictions **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission) if checking permission for self, otherwise 'Confluence Administrator' global permission is required. Authentication - Required Scopes: [read:confluence-content.permission]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to check permissions against.
      • body: The content permission request.

    • convertContentBody

      public CompletableFuture<ContentBody> convertContentBody(Consumer<ConvertContentBodyOperationSpec> spec)
      Convert content body

      Converts a content body from one format to another format. Supported conversions: - storage: view, export_view, styled_view, editor - editor: storage - view: none - export_view: none - styled_view: none **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: If request specifies 'contentIdContext', 'View' permission for the space, and permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • to: The name of the target format for the content body.
      • body: The content body to convert.
      • spaceKeyContext: The space key used for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the spaceKeyContext=TEST parameter is provided, then the link will be converted to a link to the "Example page" page in the "TEST" space.
      • contentIdContext: The content ID used to find the space for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the contentIdContext=123 parameter is provided, then the link will be converted to a link to the "Example page" page in the same space that has the content with ID=123. Note, spaceKeyContext will be ignored if this parameter is provided.
      • embeddedContentRender: Mode used for rendering embedded content, like attachments. - current renders the embedded content using the latest version. - version-at-save renders the embedded content using the version at the time of save.
      • expand: A multi-value parameter indicating which properties of the content to expand and populate. Expands are dependent on the to conversion format and may be irrelevant for certain conversions (e.g. macroRenderedOutput is redundant when converting to view format). If rendering to view format, and the body content being converted includes arbitrary nested content (such as macros); then it is necessary to include webresource expands in the request. Webresources for content body are the batched JS and CSS dependencies for any nested dynamic content (i.e. macros). - embeddedContent returns metadata for nested content (e.g. page included using page include macro) - mediaToken returns JWT token for retrieving attachment data from Media API - macroRenderedOutput additionally converts body to view format - webresource.superbatch.uris.js returns all common JS dependencies as static URLs - webresource.superbatch.uris.css returns all common CSS dependencies as static URLs - webresource.superbatch.uris.all returns all common dependencies as static URLs - webresource.superbatch.tags.all returns all common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.superbatch.tags.css returns all common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.superbatch.tags.js returns all common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags - webresource.uris.js returns JS dependencies specific to conversion - webresource.uris.css returns CSS dependencies specific to conversion - webresource.uris.all returns all dependencies specific to conversion - webresource.tags.all returns common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.tags.css returns common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.tags.js returns common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags

    • copyPage

      public CompletableFuture<Content> copyPage(Consumer<CopyPageOperationSpec> spec)
      Copy single page

      Copies a single page and its associated properties, permissions, attachments, and custom contents. The id path parameter refers to the content ID of the page to copy. The target of the page to be copied is defined using the destination in the request body and can be one of the following types. - space: page will be copied to the specified space as a root page on the space - parent_page: page will be copied as a child of the specified parent page - existing_page: page will be copied and replace the specified page By default, the following objects are expanded: space, history, version. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Add' permission for the space that the content will be copied in and permission to update the content if copying to an existing_page. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id:
      • request: Request object from json post body
      • expand: A multi-value parameter indicating which properties of the content to expand. Maximum sub-expansions allowed is 8. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.

    • copyPageHierarchy

      public CompletableFuture<LongTask> copyPageHierarchy(Consumer<CopyPageHierarchyOperationSpec> spec)
      Copy page hierarchy

      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. Response example: &lt;pre&gt;&lt;code&gt; { "id" : "1180606", "links" : { "status" : "/rest/api/longtask/1180606" } } &lt;/code&gt;&lt;/pre&gt; Use the /longtask/&lt;taskId&gt; REST API to get the copy task status. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id:
      • request: Request object from json post body

    • createAttachment

      public CompletableFuture<ContentArray> createAttachment(Consumer<CreateAttachmentOperationSpec> spec)
      Create attachment

      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](#api-content-id-child-attachment-put). Note, you must set a X-Atlassian-Token: nocheck header on the request for this method, otherwise it will be blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data. The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client libraries have classes that make it easier to implement multipart posts, like the [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class provided by Apache HTTP Components. Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used in that part. In the case of this API endpoint, the comment body parameter should be sent with type=text/plain and charset=utf-8 values. This will force the charset to be UTF-8. Example: This curl command attaches a file ('example.txt') to a container (id='123') with a comment and minorEdits=true. ` bash curl -D- \\ -u admin:admin \\ -X POST \\ -H 'X-Atlassian-Token: nocheck' \\ -F 'file=@"example.txt"' \\ -F 'minorEdit="true"' \\ -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \\ http://myhost/rest/api/content/123/child/attachment ` **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-file]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to add the attachment to.
      • _file: The relative location and name of the attachment to be added to the content.
      • minorEdit: If minorEdits is set to 'true', no notification email or activity stream will be generated when the attachment is added to the content.
      • status: The status of the content that the attachment is being added to.
      • comment: The comment for the attachment that is being added. If you specify a comment, then every file must have a comment and the comments must be in the same order as the files. Alternatively, don't specify any comments.

    • createAuditRecord

      public CompletableFuture<AuditRecord> createAuditRecord(Consumer<CreateAuditRecordOperationSpec> spec)
      Create audit record

      Creates a record in the audit log. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [read:audit-log:confluence, write:audit-log:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The record to be created in the audit log.

    • createContent

      @Deprecated public CompletableFuture<Content> createContent(Consumer<CreateContentOperationSpec> spec)
      Veraltet.
      Create content

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Creates a new piece of content or publishes an existing draft. To publish a draft, add the id and status properties to the body of the request. Set the id to the ID of the draft and set the status to 'current'. When the request is sent, a new piece of content will be created and the metadata from the draft will be transferred into it. By default, the following objects are expanded: space, history, version. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Add' permission for the space that the content will be created in, and permission to view the draft if publishing a draft. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • content: The new content to be created. Set the representation to the name of the body format type. For example, if you use storage for the body format, set 'representation=storage'. See [Confluence storage format](https://confluence.atlassian.com/x/AJkiLw). If you are not sure how to generate the different formats, you can create a page in the Confluence application, retrieve the content using [Get content](#api-content-get), and expand the desired content format, e.g. expand=body.storage.
      • status: Filter the returned content by status.
      • expand: A multi-value parameter indicating which properties of the content to expand. Maximum sub-expansions allowed is 8. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.

    • createContentProperty

      @Deprecated public CompletableFuture<ContentProperty> createContentProperty(Consumer<CreateContentPropertyOperationSpec> spec)
      Veraltet.
      Create content property

      Creates a property for an existing piece of content. For more information about content properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). This is the same as [Create content property for key](#api-content-id-property-key-post) except that the key is specified in the request body instead of as a path parameter. Content properties can also be added when creating a new piece of content by including them in the metadata.properties of the request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to add the property to.
      • body: The content property to be created.

    • createContentPropertyForKey

      @Deprecated public CompletableFuture<ContentProperty> createContentPropertyForKey(Consumer<CreateContentPropertyForKeyOperationSpec> spec)
      Veraltet.
      Create content property for key

      Creates a property for an existing piece of content. For more information about content properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). This is the same as [Create content property](#api-content-id-property-post) except that the key is specified as a path parameter instead of in the request body. Content properties can also be added when creating a new piece of content by including them in the metadata.properties of the request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to add the property to.
      • key: The key of the content property. Required.
      • body: The content property to be created.

    • createContentTemplate

      public CompletableFuture<ContentTemplate> createContentTemplate(Consumer<CreateContentTemplateOperationSpec> spec)
      Create content template

      Creates a new content template. Note, blueprint templates cannot be created via the REST API. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space to create a space template or 'Confluence Administrator' global permission to create a global template. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The content template to be created. The content body must be in 'storage' format.

    • createGroup

      public CompletableFuture<Group> createGroup(Consumer<CreateGroupOperationSpec> spec)
      Create new user group

      Creates a new user group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: Name of the group that is to be created.

    • createOrUpdateAttachments

      public CompletableFuture<ContentArray> createOrUpdateAttachments(Consumer<CreateOrUpdateAttachmentsOperationSpec> spec)
      Create or update attachment

      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). Note, you must set a X-Atlassian-Token: nocheck header on the request for this method, otherwise it will be blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data. The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client libraries have classes that make it easier to implement multipart posts, like the [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class provided by Apache HTTP Components. Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used in that part. In the case of this API endpoint, the comment body parameter should be sent with type=text/plain and charset=utf-8 values. This will force the charset to be UTF-8. Example: This curl command attaches a file ('example.txt') to a piece of content (id='123') with a comment and minorEdits=true. If the 'example.txt' file already exists, it will update it with a new version of the attachment. ` bash curl -D- \\ -u admin:admin \\ -X PUT \\ -H 'X-Atlassian-Token: nocheck' \\ -F 'file=@"example.txt"' \\ -F 'minorEdit="true"' \\ -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \\ http://myhost/rest/api/content/123/child/attachment ` **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-file]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to add the attachment to.
      • _file: The relative location and name of the attachment to be added to the content.
      • minorEdit: If minorEdits is set to 'true', no notification email or activity stream will be generated when the attachment is added to the content.
      • status: The status of the content that the attachment is being added to. This should always be set to 'current'.
      • comment: The comment for the attachment that is being added. If you specify a comment, then every file must have a comment and the comments must be in the same order as the files. Alternatively, don't specify any comments.

    • createPrivateSpace

      public CompletableFuture<Space> createPrivateSpace(Consumer<CreatePrivateSpaceOperationSpec> spec)
      Create private space

      Creates a new space that is only visible to the creator. This method is the same as the [Create space](#api-space-post) method with permissions set to the current user only. Note, currently you cannot set space labels when creating a space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Create Space(s)' global permission. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spacePrivateCreate: The space to be created.

    • createRelationship

      public CompletableFuture<Relation> createRelationship(Consumer<CreateRelationshipOperationSpec> spec)
      Create relationship

      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. For example, the following method creates a 'sibling' relationship between two pieces of content: GET /wiki/rest/api/relation/sibling/from/content/123/to/content/456 **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • relationName: The name of the relationship. This method supports the 'favourite' (i.e. 'save for later') relationship. You can also specify any other value for this parameter to create a custom relationship type.
      • sourceType: The source entity type of the relationship. This must be 'user', if the relationName is 'favourite'.
      • sourceKey: - The identifier for the source entity: - If sourceType is 'user', then specify either 'current' (logged-in user) or the user key. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • targetType: The target entity type of the relationship. This must be 'space' or 'content', if the relationName is 'favourite'.
      • targetKey: - The identifier for the target entity: - If sourceType is 'user', then specify either 'current' (logged-in user) or the user key. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • sourceStatus: The status of the source. This parameter is only used when the sourceType is 'content'.
      • targetStatus: The status of the target. This parameter is only used when the targetType is 'content'.
      • sourceVersion: The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.
      • targetVersion: The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.

    • createSpace

      public CompletableFuture<Space> createSpace(Consumer<CreateSpaceOperationSpec> spec)
      Create space

      Creates a new space. Note, currently you cannot set space labels when creating a space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Create Space(s)' global permission. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The space to be created.

    • createSpaceProperty

      @Deprecated public CompletableFuture<SpaceProperty> createSpaceProperty(Consumer<CreateSpacePropertyOperationSpec> spec)
      Veraltet.
      Create space property

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Creates a new space property. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘Admin’ permission for the space. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space that the property will be created in.
      • body: The space property to be created.

    • createSpacePropertyForKey

      @Deprecated public CompletableFuture<SpaceProperty> createSpacePropertyForKey(Consumer<CreateSpacePropertyForKeyOperationSpec> spec)
      Veraltet.
      Create space property for key

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Creates a new space property. This is the same as POST /wiki/rest/api/space/{spaceKey}/property but the key for the property is passed as a path parameter, rather than in the request body. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘Admin’ permission for the space. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space that the property will be created in.
      • key: The key of the property to be created.
      • body: The space property to be created.

    • createUserProperty

      public CompletableFuture<Void> createUserProperty(Consumer<CreateUserPropertyOperationSpec> spec)
      Create user property by key

      Creates a property for a user. For more information about user properties, see [Confluence entity properties] (https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). Note, these properties stored against a user are on a Confluence site level and not space/content level. Note: the number of properties which could be created per app in a tenant for each user might be restricted by fixed system limits. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:user.property:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • userId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192
      • key: The key of the user property.
      • body: The user property to be created.

    • deleteContent

      @Deprecated public CompletableFuture<Void> deleteContent(Consumer<DeleteContentOperationSpec> spec)
      Veraltet.
      Delete content

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Moves a piece of content to the space's trash or purges it from the trash, depending on the content's type and status: - If the content's type is page,blogpost, or attachment and its status is current, it will be trashed. - If the content's type is page,blogpost, or attachment and its status is trashed, the content will be purged from the trash and deleted permanently. Note, you must also set the status query parameter to trashed in your request. - If the content's type is comment, it will be deleted permanently without being trashed. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Delete' permission for the space that the content is in. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be deleted.
      • status: Set this to trashed, if the content's status is trashed and you want to purge it.

    • deleteContentProperty

      @Deprecated public CompletableFuture<Void> deleteContentProperty(Consumer<DeleteContentPropertyOperationSpec> spec)
      Veraltet.
      Delete content property

      Deletes a content property. For more information about content properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the property belongs to.
      • key: The key of the property.

    • deleteContentVersion

      public CompletableFuture<Void> deleteContentVersion(Consumer<DeleteContentVersionOperationSpec> spec)
      Delete content version

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the version will be deleted from.
      • versionNumber: The number of the version to be deleted. The version number starts from 1 up to current version.

    • deleteLabelFromSpace

      public CompletableFuture<Void> deleteLabelFromSpace(Consumer<DeleteLabelFromSpaceOperationSpec> spec)
      Remove label from a space Authentication - Required Scopes: [write:confluence-space]
      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to remove a labels from.
      • name: The name of the label to remove
      • prefix: The prefix of the label to remove. If not provided defaults to global.

    • deletePageTree

      public CompletableFuture<LongTask> deletePageTree(Consumer<DeletePageTreeOperationSpec> spec)
      Delete page tree

      Moves a pagetree rooted at a page to the space's trash: - If the content's type is page and its status is current, it will be trashed including all its descendants. - For every other combination of content type and status, this API is not supported. This API accepts the pageTree delete request and returns a task ID. The delete process happens asynchronously. Response example: &lt;pre&gt;&lt;code&gt; { "id" : "1180606", "links" : { "status" : "/rest/api/longtask/1180606" } } &lt;/code&gt;&lt;/pre&gt; Use the /longtask/&amp;lt;taskId&amp;gt; REST API to get the copy task status. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Delete' permission for the space that the content is in. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content which forms root of the page tree, to be deleted.

    • deleteRelationship

      public CompletableFuture<Void> deleteRelationship(Consumer<DeleteRelationshipOperationSpec> spec)
      Delete relationship

      Deletes a relationship between two entities (user, space, content). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). For favourite relationships, the current user can only delete their own favourite relationships. A space administrator can delete favourite relationships for any user. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • relationName: The name of the relationship.
      • sourceType: The source entity type of the relationship. This must be 'user', if the relationName is 'favourite'.
      • sourceKey: - The identifier for the source entity: - If sourceType is 'user', then specify either 'current' (logged-in user) or the user key. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • targetType: The target entity type of the relationship. This must be 'space' or 'content', if the relationName is 'favourite'.
      • targetKey: - The identifier for the target entity: - If sourceType is 'user', then specify either 'current' (logged-in user) or the user key. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • sourceStatus: The status of the source. This parameter is only used when the sourceType is 'content'.
      • targetStatus: The status of the target. This parameter is only used when the targetType is 'content'.
      • sourceVersion: The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.
      • targetVersion: The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.

    • deleteRestrictions

      public CompletableFuture<ContentRestrictionArray> deleteRestrictions(Consumer<DeleteRestrictionsOperationSpec> spec)
      Delete restrictions

      Removes all restrictions (read and update) on a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to remove restrictions from.
      • expand: A multi-value parameter indicating which properties of the content restrictions (returned in response) to expand. - restrictions.user returns the piece of content that the restrictions are applied to. Expanded by default. - restrictions.group returns the piece of content that the restrictions are applied to. Expanded by default. - content returns the piece of content that the restrictions are applied to.

    • deleteSpace

      public CompletableFuture<LongTask> deleteSpace(Consumer<DeleteSpaceOperationSpec> spec)
      Delete space

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to delete.

    • deleteSpaceProperty

      @Deprecated public CompletableFuture<Void> deleteSpaceProperty(Consumer<DeleteSpacePropertyOperationSpec> spec)
      Veraltet.
      Delete space property

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Deletes a space property. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘Admin’ permission for the space. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space that the property is in.
      • key: The key of the property to be deleted.

    • deleteUserProperty

      public CompletableFuture<Void> deleteUserProperty(Consumer<DeleteUserPropertyOperationSpec> spec)
      Delete user property

      Deletes a property for the given user. For more information about user properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). Note, these properties stored against a user are on a Confluence site level and not space/content level. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:user.property:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • userId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192
      • key: The key of the user property.

    • downloadAttatchment

      public CompletableFuture<Void> downloadAttatchment(Consumer<DownloadAttatchmentOperationSpec> spec)
      Get URI to download attachment

      Redirects the client to a URL that serves an attachment's binary data. Authentication - Required Scopes: [readonly:content.attachment:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the attachment is attached to.
      • attachmentId: The ID of the attachment to download.
      • version: The version of the attachment. If this parameter is absent, the redirect URI will download the latest version of the attachment.

    • exportAuditRecords

      public CompletableFuture<File> exportAuditRecords(Consumer<ExportAuditRecordsOperationSpec> spec)
      Export audit records

      Exports audit records as a CSV file or ZIP file. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [read:audit-log:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • startDate: Filters the exported results to the records on or after the startDate. The startDate must be specified as a [timestamp](https://www.unixtimestamp.com/).
      • endDate: Filters the exported results to the records on or before the endDate. The endDate must be specified as a [timestamp](https://www.unixtimestamp.com/).
      • searchString: Filters the exported results to records that have string property values matching the searchString.
      • format: The format of the export file for the audit records.

    • findSourcesForTarget

      public CompletableFuture<RelationArray> findSourcesForTarget(Consumer<FindSourcesForTargetOperationSpec> spec)
      Find source entities related to a target entity

      Returns all target entities that have a particular relationship to the source entity. Note, relationships are one way. For example, the following method finds all users that have a 'collaborator' relationship to a piece of content with an ID of '1234': GET /wiki/rest/api/relation/collaborator/to/content/1234/from/user Note, 'collaborator' is an example custom relationship type. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view both the target entity and source entity. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • relationName: The name of the relationship. This method supports relationships created via [Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put). Note, this method does not support 'like' or 'favourite' relationships.
      • sourceType: The source entity type of the relationship.
      • targetType: The target entity type of the relationship.
      • targetKey: The identifier for the target entity: - If targetType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details. - If targetType is 'content', then specify the content ID. - If targetType is 'space', then specify the space key.
      • sourceStatus: The status of the source. This parameter is only used when the sourceType is 'content'.
      • targetStatus: The status of the target. This parameter is only used when the targetType is 'content'.
      • sourceVersion: The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.
      • targetVersion: The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.
      • expand: A multi-value parameter indicating which properties of the response object to expand. - relationData returns information about the relationship, such as who created it and when it was created. - source returns the source entity. - target returns the target entity.
      • start: The starting index of the returned relationships.
      • limit: The maximum number of relationships to return per page. Note, this may be restricted by fixed system limits.

    • findTargetFromSource

      public CompletableFuture<RelationArray> findTargetFromSource(Consumer<FindTargetFromSourceOperationSpec> spec)
      Find target entities related to a source entity

      Returns all target entities that have a particular relationship to the source entity. Note, relationships are one way. For example, the following method finds all content that the current user has an 'ignore' relationship with: GET /wiki/rest/api/relation/ignore/from/user/current/to/content Note, 'ignore' is an example custom relationship type. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view both the target entity and source entity. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • relationName: The name of the relationship. This method supports relationships created via [Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put). Note, this method does not support 'like' or 'favourite' relationships.
      • sourceType: The source entity type of the relationship.
      • sourceKey: The identifier for the source entity: - If sourceType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • targetType: The target entity type of the relationship.
      • sourceStatus: The status of the source. This parameter is only used when the sourceType is 'content'.
      • targetStatus: The status of the target. This parameter is only used when the targetType is 'content'.
      • sourceVersion: The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.
      • targetVersion: The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.
      • expand: A multi-value parameter indicating which properties of the response object to expand. - relationData returns information about the relationship, such as who created it and when it was created. - source returns the source entity. - target returns the target entity.
      • start: The starting index of the returned relationships.
      • limit: The maximum number of relationships to return per page. Note, this may be restricted by fixed system limits.

    • getAllLabelContent

      public CompletableFuture<LabelDetails> getAllLabelContent(Consumer<GetAllLabelContentOperationSpec> spec)
      Get label information

      Returns label information and a list of contents associated with the label. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Only contents that the user is permitted to view is returned. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: Name of the label to query.
      • type: The type of contents that are to be returned.
      • start: The starting offset for the results.
      • limit: The number of results to be returned.

    • getAndAsyncConvertMacroBodyByMacroId

      public CompletableFuture<AsyncId> getAndAsyncConvertMacroBodyByMacroId(Consumer<GetAndAsyncConvertMacroBodyByMacroIdOperationSpec> spec)
      Get macro body by macro ID and convert representation Asynchronously

      Returns Async Id of the conversion task which will convert the macro into a content body of the desired format. The result will be available for 5 minutes after completion of the conversion. About the macro ID: When a macro is created in a new version of content, Confluence will generate a random ID for it, unless an ID is specified (by an app). The macro ID will look similar to this: '884bd9-0cb8-41d5-98be-f80943c14f96'. The ID is then persisted as new versions of content are created, and is only modified by Confluence if there are conflicting IDs. Note, to preserve backwards compatibility this resource will also match on the hash of the macro body, even if a macro ID is found. This check will eventually become redundant, as macro IDs are generated for pages and transparently propagate out to all instances. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content that the macro is in. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID for the content that contains the macro.
      • version: The version of the content that contains the macro. Specifying 0 as the version will return the macro body for the latest content version.
      • macroId: The ID of the macro. For apps, this is passed to the macro by the Connect/Forge framework. Otherwise, find the macro ID by querying the desired content and version, then expanding the body in storage format. For example, '/content/196611/version/7?expand=content.body.storage'.
      • to: The content representation to return the macro in. Currently, the following conversions are allowed: - export_view - styled_view - view
      • expand: A multi-value parameter indicating which properties of the content to expand and populate. Expands are dependent on the to conversion format and may be irrelevant for certain conversions (e.g. macroRenderedOutput is redundant when converting to view format). If rendering to view format, and the body content being converted includes arbitrary nested content (such as macros); then it is necessary to include webresource expands in the request. Webresources for content body are the batched JS and CSS dependencies for any nested dynamic content (i.e. macros). - embeddedContent returns metadata for nested content (e.g. page included using page include macro) - mediaToken returns JWT token for retrieving attachment data from Media API - macroRenderedOutput additionally converts body to view format - webresource.superbatch.uris.js returns all common JS dependencies as static URLs - webresource.superbatch.uris.css returns all common CSS dependencies as static URLs - webresource.superbatch.uris.all returns all common dependencies as static URLs - webresource.superbatch.tags.all returns all common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.superbatch.tags.css returns all common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.superbatch.tags.js returns all common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags - webresource.uris.js returns JS dependencies specific to conversion - webresource.uris.css returns CSS dependencies specific to conversion - webresource.uris.all returns all dependencies specific to conversion - webresource.tags.all returns common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.tags.css returns common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.tags.js returns common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags
      • allowCache: If this field is false, the cache will erase its current value and begin a conversion. If this field is true, the cache will not erase its current value, and will set the status of the result in cache to RERUNNING. Once the data is updated, the status will change to COMPLETED. Large macros that take long to convert, and who want to show intermediate, but potentially stale data, immediately should set this field to true. Cache values are stored per macro per user per content and expansions.
      • spaceKeyContext: The space key used for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the spaceKeyContext=TEST parameter is provided, then the link will be converted to a link to the "Example page" page in the "TEST" space.
      • embeddedContentRender: Mode used for rendering embedded content, like attachments. - current renders the embedded content using the latest version. - version-at-save renders the embedded content using the version at the time of save.

    • getAndConvertMacroBodyByMacroId

      public CompletableFuture<ContentBody> getAndConvertMacroBodyByMacroId(Consumer<GetAndConvertMacroBodyByMacroIdOperationSpec> spec)
      Get macro body by macro ID and convert the representation synchronously

      Returns the body of a macro in format specified in path, for the given macro ID. This includes information like the name of the macro, the body of the macro, and any macro parameters. About the macro ID: When a macro is created in a new version of content, Confluence will generate a random ID for it, unless an ID is specified (by an app). The macro ID will look similar to this: '50884bd9-0cb8-41d5-98be-f80943c14f96'. The ID is then persisted as new versions of content are created, and is only modified by Confluence if there are conflicting IDs. Note, to preserve backwards compatibility this resource will also match on the hash of the macro body, even if a macro ID is found. This check will eventually become redundant, as macro IDs are generated for pages and transparently propagate out to all instances. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content that the macro is in. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID for the content that contains the macro.
      • version: The version of the content that contains the macro. Specifying 0 as the version will return the macro body for the latest content version.
      • macroId: The ID of the macro. This is usually passed by the app that the macro is in. Otherwise, find the macro ID by querying the desired content and version, then expanding the body in storage format. For example, '/content/196611/version/7?expand=content.body.storage'.
      • to: The content representation to return the macro in.
      • expand: A multi-value parameter indicating which properties of the content to expand and populate. Expands are dependent on the to conversion format and may be irrelevant for certain conversions (e.g. macroRenderedOutput is redundant when converting to view format). If rendering to view format, and the body content being converted includes arbitrary nested content (such as macros); then it is necessary to include webresource expands in the request. Webresources for content body are the batched JS and CSS dependencies for any nested dynamic content (i.e. macros). - embeddedContent returns metadata for nested content (e.g. page included using page include macro) - mediaToken returns JWT token for retrieving attachment data from Media API - macroRenderedOutput additionally converts body to view format - webresource.superbatch.uris.js returns all common JS dependencies as static URLs - webresource.superbatch.uris.css returns all common CSS dependencies as static URLs - webresource.superbatch.uris.all returns all common dependencies as static URLs - webresource.superbatch.tags.all returns all common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.superbatch.tags.css returns all common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.superbatch.tags.js returns all common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags - webresource.uris.js returns JS dependencies specific to conversion - webresource.uris.css returns CSS dependencies specific to conversion - webresource.uris.all returns all dependencies specific to conversion - webresource.tags.all returns common JS dependencies as html &amp;lt;script&amp;gt; tags - webresource.tags.css returns common CSS dependencies as html &amp;lt;style&amp;gt; tags - webresource.tags.js returns common dependencies as html &amp;lt;script&amp;gt; and &amp;lt;style&amp;gt; tags
      • spaceKeyContext: The space key used for resolving embedded content (page includes, files, and links) in the content body. For example, if the source content contains the link &amp;lt;ac:link&amp;gt;&amp;lt;ri:page ri:content-title="Example page" /&amp;gt;&amp;lt;ac:link&amp;gt; and the spaceKeyContext=TEST parameter is provided, then the link will be converted to a link to the "Example page" page in the "TEST" space.
      • embeddedContentRender: Mode used for rendering embedded content, like attachments. - current renders the embedded content using the latest version. - version-at-save renders the embedded content using the version at the time of save.

    • getAnonymousUser

      public CompletableFuture<UserAnonymous> getAnonymousUser(Consumer<GetAnonymousUserOperationSpec> spec)
      Get anonymous user

      Returns information about how anonymous users are represented, like the profile picture and display name. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-user]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do.

    • getAttachments

      @Deprecated public CompletableFuture<ContentArray> getAttachments(Consumer<GetAttachmentsOperationSpec> spec)
      Veraltet.
      Get attachments

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns the attachments for a piece of content. By default, the following objects are expanded: metadata. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the content is a blog post, 'View' permission for the space is required. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its attachments.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • start: The starting index of the returned attachments.
      • limit: The maximum number of attachments to return per page. Note, this may be restricted by fixed system limits.
      • filename: Filter the results to attachments that match the filename.
      • mediaType: Filter the results to attachments that match the media type.

    • getAuditRecords

      public CompletableFuture<AuditRecordArray> getAuditRecords(Consumer<GetAuditRecordsOperationSpec> spec)
      Get audit records

      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](https://confluence.atlassian.com/confcloud/audit-log-802164269.html) in the Confluence administrator's guide. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [read:audit-log:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • startDate: Filters the results to the records on or after the startDate. The startDate must be specified as a [timestamp](https://www.unixtimestamp.com/).
      • endDate: Filters the results to the records on or before the endDate. The endDate must be specified as a [timestamp](https://www.unixtimestamp.com/).
      • searchString: Filters the results to records that have string property values matching the searchString.
      • start: The starting index of the returned records.
      • limit: The maximum number of records to return per page. Note, this may be restricted by fixed system limits.

    • getAuditRecordsForTimePeriod

      public CompletableFuture<AuditRecordArray> getAuditRecordsForTimePeriod(Consumer<GetAuditRecordsForTimePeriodOperationSpec> spec)
      Get audit records for time period

      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. This contains information about events like space exports, group membership changes, app installations, etc. For more information, see [Audit log](https://confluence.atlassian.com/confcloud/audit-log-802164269.html) in the Confluence administrator's guide. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [read:audit-log:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • number: The number of units for the time period.
      • units: The unit of time that the time period is measured in.
      • searchString: Filters the results to records that have string property values matching the searchString.
      • start: The starting index of the returned records.
      • limit: The maximum number of records to return per page. Note, this may be restricted by fixed system limits.

    • getAvailableContentStates

      public CompletableFuture<AvailableContentStates> getAvailableContentStates(Consumer<GetAvailableContentStatesOperationSpec> spec)
      Gets available content states for content.

      Gets content states that are available for the content to be set as. Will return all enabled Space Content States. Will only return most the 3 most recently published custom content states to match UI editor list. To get all custom content states, use the /content-states endpoint. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: id of content to get available states for

    • getBlueprintTemplates

      public CompletableFuture<BlueprintTemplateArray> getBlueprintTemplates(Consumer<GetBlueprintTemplatesOperationSpec> spec)
      Get blueprint templates

      Returns all templates provided by blueprints. Use this method to retrieve all global blueprint templates or all blueprint templates in a space. Note, all global blueprints are inherited by each space. Space blueprints can be customised without affecting the global blueprints. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space to view blueprints for the space and permission to access the Confluence site ('Can use' global permission) to view global blueprints. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for templates. If the spaceKey is not specified, global blueprint templates will be returned.
      • start: The starting index of the returned templates.
      • limit: The maximum number of templates to return per page. Note, this may be restricted by fixed system limits.
      • expand: A multi-value parameter indicating which properties of the template to expand. - body returns the content of the template in storage format.

    • getBulkUserLookup

      public CompletableFuture<BulkUserLookupArray> getBulkUserLookup(Consumer<GetBulkUserLookupOperationSpec> spec)
      Get multiple users using ids

      Returns user details for the ids provided in request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-user]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • accountId: A list of accountId's of users to be returned.
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do. - personalSpace returns the user's personal space, if it exists. - isExternalCollaborator returns whether the user is an external collaborator user.
      • limit: The maximum number of results returned. Currently API returns 200 results max. If more that 200 ids are passed first 200 will be returned.

    • getContent

      @Deprecated public CompletableFuture<ContentArray> getContent(Consumer<GetContentOperationSpec> spec)
      Veraltet.
      Get content

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns all content in a Confluence instance. By default, the following objects are expanded: space, history, version. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Only content that the user has permission to view will be returned. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • type: The type of content to return. For example: - page - blogpost
      • spaceKey: The key of the space to be queried for its content.
      • title: The title of the page to be returned. Required for &lt;code&gt;page&lt;/code&gt; type.
      • status: Filter the results to a set of content based on their status. If set to any, content with any status is returned. Note, the historical status is currently not supported.
      • postingDay: The posting date of the blog post to be returned. Required for &lt;code&gt;blogpost&lt;/code&gt; type. Format: &lt;code&gt;yyyy-mm-dd&lt;/code&gt;.
      • expand: A multi-value parameter indicating which properties of the content to expand. Maximum sub-expansions allowed is 8. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • trigger: If set to viewed, the request will trigger a 'viewed' event for the content. When this event is triggered, the page/blogpost will appear on the 'Recently visited' tab of the user's Confluence dashboard.
      • orderby: Orders the content by a particular field. Specify the field and sort direction for this parameter, as follows: 'fieldpath asc/desc'. For example, 'history.createdDate desc'.
      • start: The starting index of the returned content.
      • limit: The maximum number of content objects to return per page. Note, this may be restricted by fixed system limits.

    • getContentById

      @Deprecated public CompletableFuture<Content> getContentById(Consumer<GetContentByIdOperationSpec> spec)
      Veraltet.
      Get content by ID

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns a single piece of content, like a page or a blog post. By default, the following objects are expanded: space, history, version. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the content is a blog post, 'View' permission for the space is required. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be returned. If you don't know the content ID, use [Get content](#api-content-get) and filter the results.
      • status: Filter the results to a set of content based on their status. If set to any, content with any status is returned. Note, the historical status is currently not supported.
      • version: The version number of the content to be returned.
      • embeddedContentRender: The version of embedded content (e.g. attachments) to render. - &lt;code&gt;current&lt;/code&gt; renders the latest version of the embedded content. - &lt;code&gt;version-at-save&lt;/code&gt; renders the version of the embedded content at the time of save.
      • expand: A multi-value parameter indicating which properties of the content to expand. Maximum sub-expansions allowed is 8. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • trigger: If set to viewed, the request will trigger a 'viewed' event for the content. When this event is triggered, the page/blogpost will appear on the 'Recently visited' tab of the user's Confluence dashboard.

    • getContentByTypeForSpace

      @Deprecated public CompletableFuture<ContentArray> getContentByTypeForSpace(Consumer<GetContentByTypeForSpaceOperationSpec> spec)
      Veraltet.
      Get content by type for space

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns all content of a given type, in a space. The returned content is ordered by content ID in ascending order. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space. Note, the returned list will only contain content that the current user has permission to view. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content.
      • type: The type of content to return. page, blogpost, &amp;lt;some_customContentType&amp;gt;.
      • depth: Filter the results to content at the root level of the space or all content.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • start: The starting index of the returned content.
      • limit: The maximum number of content objects to return per page. Note, this may be restricted by fixed system limits.

    • getContentChildren

      @Deprecated public CompletableFuture<ContentChildren> getContentChildren(Consumer<GetContentChildrenOperationSpec> spec)
      Veraltet.
      Get content children

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). 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: - page: child content is page, comment, attachment - blogpost: child content is comment, attachment - attachment: child content is comment - comment: child content is attachment Apps can override these default relationships. Apps can also introduce new content types that create new parent-child content relationships. Note, the map will always include all child content types that are valid for the content. However, if the content has no instances of a child content type, the map will contain an empty array for that child content type. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its children.
      • expand: A multi-value parameter indicating which properties of the children to expand, where: - attachment returns all attachments for the content. - comments returns all comments for the content. - page returns all child pages of the content. - Custom content types that are provided by apps are also supported.
      • parentVersion: The version of the parent content to retrieve children for. Currently, this only works for the latest version.

    • getContentChildrenByType

      @Deprecated public CompletableFuture<ContentArray> getContentChildrenByType(Consumer<GetContentChildrenByTypeOperationSpec> spec)
      Veraltet.
      Get content children by type

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). 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: - page: child content is page, comment, attachment - blogpost: child content is comment, attachment - attachment: child content is comment - comment: child content is attachment Custom content types that are provided by apps can also be returned. Note, this method only returns direct children. To return children at all levels, use [Get descendants by type](#api-content-id-descendant-type-get). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its children.
      • type: The type of children to return.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • parentVersion: The version of the parent content to retrieve children for. Currently, this only works for the latest version.
      • start: The starting index of the returned content.
      • limit: The maximum number of content to return per page. Note, this may be restricted by fixed system limits.

    • getContentComments

      @Deprecated public CompletableFuture<ContentArray> getContentComments(Consumer<GetContentCommentsOperationSpec> spec)
      Veraltet.
      Get content comments

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns the comments on a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its comments.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • parentVersion: The version of the parent content to retrieve children for. Currently, this only works for the latest version.
      • start: The starting index of the returned comments.
      • limit: The maximum number of comments to return per page. Note, this may be restricted by fixed system limits.
      • location: The location of the comments in the page. Multiple locations can be specified. If no location is specified, comments from all locations are returned.
      • depth: Currently, this parameter is not used. Comments are returned at the root level only.

    • getContentDescendants

      public CompletableFuture<ContentChildren> getContentDescendants(Consumer<GetContentDescendantsOperationSpec> spec)
      Get content descendants

      Returns a map of the descendants of a piece of content. This is similar to [Get content children](#api-content-id-child-get), except that this method returns child pages at all levels, rather than just the direct child pages. A piece of content has different types of descendants, depending on its type: - page: descendant is page, comment, attachment - blogpost: descendant is comment, attachment - attachment: descendant is comment - comment: descendant is attachment The map will always include all descendant types that are valid for the content. However, if the content has no instances of a descendant type, the map will contain an empty array for that descendant type. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its descendants.
      • expand: A multi-value parameter indicating which properties of the children to expand, where: - attachment returns all attachments for the content. - comments returns all comments for the content. - page returns all child pages of the content.

    • getContentForSpace

      @Deprecated public CompletableFuture<GetContentForSpace200Response> getContentForSpace(Consumer<GetContentForSpaceOperationSpec> spec)
      Veraltet.
      Get content for space

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns all content in a space. The returned content is grouped by type (pages then blogposts), then ordered by content ID in ascending order. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space. Note, the returned list will only contain content that the current user has permission to view. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content.
      • depth: Filter the results to content at the root level of the space or all content.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • start: The starting index of the returned content.
      • limit: The maximum number of content objects to return per page. Note, this may be restricted by fixed system limits.

    • getContentProperties

      @Deprecated public CompletableFuture<ContentPropertyArray> getContentProperties(Consumer<GetContentPropertiesOperationSpec> spec)
      Veraltet.
      Get content properties

      Returns the properties for a piece of content. For more information about content properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its properties.
      • key: The key of the content property.
      • expand: A multi-value parameter indicating which properties of the content to expand. By default, the version object is expanded. - content returns the content that the property is stored against. - version returns information about the version of the property, such as the version number, when it was created, etc.
      • start: The starting index of the returned properties.
      • limit: The maximum number of properties to return per page. Note, this may be restricted by fixed system limits.

    • getContentProperty

      @Deprecated public CompletableFuture<ContentProperty> getContentProperty(Consumer<GetContentPropertyOperationSpec> spec)
      Veraltet.
      Get content property

      Returns a content property for a piece of content. For more information, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for the property.
      • key: The key of the content property.
      • expand: A multi-value parameter indicating which properties of the content to expand. By default, the version object is expanded. - content returns the content that the property is stored against. - version returns information about the version of the property, such as the version number, when it was created, etc.
      • status: Filter the results to a set of content based on their status. If set to any, content with any status is returned. By default it will fetch current and archived statuses ?status=current&amp;status=archived. All supported statuses - any - archived - current - deleted - draft - trashed

    • getContentRestrictionStatusForGroup

      @Deprecated public CompletableFuture<Void> getContentRestrictionStatusForGroup(Consumer<GetContentRestrictionStatusForGroupOperationSpec> spec)
      Veraltet.
      Get content restriction status for group

      Deprecated, use [Get content restriction status for group via groupId](https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-restrictions/#api-wiki-rest-api-content-id-restriction-byoperation-operationkey-bygroupid-groupid-get). Returns whether the specified content restriction applies to a group. For example, if a page with id=123 has a read restriction for the admins group, the following request will return true: /wiki/rest/api/content/123/restriction/byOperation/read/group/admins Note that a response of true does not guarantee that the group can view the page, as it does not account for account-inherited restrictions, space permissions, or even product access. For more information, see [Confluence permissions](https://confluence.atlassian.com/x/_AozKw). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupName: The name of the group to be queried for whether the content restriction applies to it.

    • getContentRestrictionStatusForUser

      public CompletableFuture<Void> getContentRestrictionStatusForUser(Consumer<GetContentRestrictionStatusForUserOperationSpec> spec)
      Get content restriction status for user

      Returns whether the specified content restriction applies to a user. For example, if a page with id=123 has a read restriction for a user with an account ID of 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192, the following request will return true: /wiki/rest/api/content/123/restriction/byOperation/read/user?accountId=384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192 Note that a response of true does not guarantee that the user can view the page, as it does not account for account-inherited restrictions, space permissions, or even product access. For more information, see [Confluence permissions](https://confluence.atlassian.com/x/_AozKw). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that is restricted.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • getContentState

      public CompletableFuture<ContentStateResponse> getContentState(Consumer<GetContentStateOperationSpec> spec)
      Get content state

      Gets the current content state of the draft or current version of content. To specify the draft version, set the parameter status to draft, otherwise archived or current will get the relevant published state. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The id of the content whose content state is of interest.
      • status: Set status to one of [current,draft,archived]. Default value is current.

    • getContentStateSettings

      public CompletableFuture<ContentStateSettings> getContentStateSettings(Consumer<GetContentStateSettingsOperationSpec> spec)
      Get content state settings for space

      Get object describing whether content states are allowed at all, if custom content states or space content states are restricted, and a list of space content states allowed for the space if they are not restricted. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Space admin permission Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content state settings.

    • getContentTemplate

      public CompletableFuture<ContentTemplate> getContentTemplate(Consumer<GetContentTemplateOperationSpec> spec)
      Get content template

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space to view space templates and permission to access the Confluence site ('Can use' global permission) to view global templates. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentTemplateId: The ID of the content template to be returned.

    • getContentTemplates

      public CompletableFuture<ContentTemplateArray> getContentTemplates(Consumer<GetContentTemplatesOperationSpec> spec)
      Get content templates

      Returns all content templates. Use this method to retrieve all global content templates or all content templates in a space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space to view space templates and permission to access the Confluence site ('Can use' global permission) to view global templates. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for templates. If the spaceKey is not specified, global templates will be returned.
      • start: The starting index of the returned templates.
      • limit: The maximum number of templates to return per page. Note, this may be restricted by fixed system limits.
      • expand: A multi-value parameter indicating which properties of the template to expand. - body returns the content of the template in storage format.

    • getContentVersion

      @Deprecated public CompletableFuture<Version> getContentVersion(Consumer<GetContentVersionOperationSpec> spec)
      Veraltet.
      Get content version

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns a version for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the content is a blog post, 'View' permission for the space is required. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its version.
      • versionNumber: The number of the version to be retrieved.
      • expand: A multi-value parameter indicating which properties of the content to expand. By default, the content object is expanded. - collaborators returns the users that collaborated on the version. - content returns the content for the version.

    • getContentVersions

      @Deprecated public CompletableFuture<VersionArray> getContentVersions(Consumer<GetContentVersionsOperationSpec> spec)
      Veraltet.
      Get content versions

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns the versions for a piece of content in descending order. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the content is a blog post, 'View' permission for the space is required. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its versions.
      • start: The starting index of the returned versions.
      • limit: The maximum number of versions to return per page. Note, this may be restricted by fixed system limits.
      • expand: A multi-value parameter indicating which properties of the content to expand. By default, the content object is expanded. - collaborators returns the users that collaborated on the version. - content returns the content for the version.

    • getContentWatchStatus

      public CompletableFuture<UserWatch> getContentWatchStatus(Consumer<GetContentWatchStatusOperationSpec> spec)
      Get content watch status

      Returns whether a user is watching a piece of content. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentId: The ID of the content to be queried for whether the specified user is watching it.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • getContentsWithState

      public CompletableFuture<ContentArray> getContentsWithState(Consumer<GetContentsWithStateOperationSpec> spec)
      Get content in space with given content state

      Finds paginated content with **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Space View Permission Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content state settings.
      • stateId: The id of the content state to filter content by
      • expand: A multi-value parameter indicating which properties of the content to expand. Options include: space, version, history, children, etc. Ex: space,version
      • limit: Maximum number of results to return
      • start: Number of result to start returning. (0 indexed)

    • getCurrentUser

      public CompletableFuture<User> getCurrentUser(Consumer<GetCurrentUserOperationSpec> spec)
      Get current user

      Returns the currently logged-in user. This includes information about the user, like the display name, userKey, account ID, profile picture, and more. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-user]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do. - personalSpace returns the user's personal space, if it exists. - isExternalCollaborator returns whether the user is an external collaborator user.

    • getCustomContentStates

      public CompletableFuture<List<ContentState>> getCustomContentStates()
      Get Custom Content States

      Get custom content states that authenticated user has created. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required** Must have user authentication. Authentication - Required Scopes: [read:user.property:confluence]

    • getDescendantsOfType

      public CompletableFuture<ContentArray> getDescendantsOfType(Consumer<GetDescendantsOfTypeOperationSpec> spec)
      Get content descendants by type

      Returns all descendants of a given type, for a piece of content. This is similar to [Get content children by type](#api-content-id-child-type-get), except that this method returns child pages at all levels, rather than just the direct child pages. A piece of content has different types of descendants, depending on its type: - page: descendant is page, comment, attachment - blogpost: descendant is comment, attachment - attachment: descendant is comment - comment: descendant is attachment Custom content types that are provided by apps can also be returned. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its descendants.
      • type: The type of descendants to return.
      • depth: Filter the results to descendants upto a desired level of the content. Note, the maximum value supported is 100. root level of the content means immediate (level 1) descendants of the type requested. all represents returning all descendants of the type requested.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • start: The starting index of the returned content.
      • limit: The maximum number of content to return per page. Note, this may be restricted by fixed system limits.

    • getGlobalTheme

      public CompletableFuture<Theme> getGlobalTheme()
      Get global theme

      Returns the globally assigned theme. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: None Authentication - Required Scopes: [manage:confluence-configuration]

    • getGroupByGroupId

      public CompletableFuture<Group> getGroupByGroupId(Consumer<GetGroupByGroupIdOperationSpec> spec)
      Get group

      Returns a user group for a given group id. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The id of the group.

    • getGroupByName

      @Deprecated public CompletableFuture<Group> getGroupByName(Consumer<GetGroupByNameOperationSpec> spec)
      Veraltet.
      Get group

      Returns a user group for a given group name. Use updated Get group API **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupName: The name of the group. This is the same as the group name shown in the Confluence administration console.

    • getGroupByQueryParam

      @Deprecated public CompletableFuture<Group> getGroupByQueryParam(Consumer<GetGroupByQueryParamOperationSpec> spec)
      Veraltet.
      Get group

      Returns a user group for a given group name. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: The name of the group. This is the same as the group name shown in the Confluence administration console.

    • getGroupMembers

      @Deprecated public CompletableFuture<UserArray> getGroupMembers(Consumer<GetGroupMembersOperationSpec> spec)
      Veraltet.
      Get group members

      Returns the users that are members of a group. Use updated Get group API **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupName: The name of the group to be queried for its members.
      • start: The starting index of the returned users.
      • limit: The maximum number of users to return per page. Note, this may be restricted by fixed system limits.

    • getGroupMembersByGroupId

      public CompletableFuture<UserArray> getGroupMembersByGroupId(Consumer<GetGroupMembersByGroupIdOperationSpec> spec)
      Get group members

      Returns the users that are members of a group. Use updated Get group API **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: The id of the group to be queried for its members.
      • start: The starting index of the returned users.
      • limit: The maximum number of users to return per page. Note, this may be restricted by fixed system limits.
      • shouldReturnTotalSize: Whether to include total size parameter in the results. Note, fetching total size property is an expensive operation; use it if your use case needs this value.
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do. - personalSpace returns the user's personal space, if it exists. - isExternalCollaborator returns whether the user is an external collaborator user.

    • getGroupMembershipsForUser

      public CompletableFuture<GroupArrayWithLinks> getGroupMembershipsForUser(Consumer<GetGroupMembershipsForUserOperationSpec> spec)
      Get group memberships for user

      Returns the groups that a user is a member of. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-user]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.
      • start: The starting index of the returned groups.
      • limit: The maximum number of groups to return per page. Note, this may be restricted by fixed system limits.

    • getGroups

      public CompletableFuture<GroupArrayWithLinks> getGroups(Consumer<GetGroupsOperationSpec> spec)
      Get groups

      Returns all user groups. The returned groups are ordered alphabetically in ascending order by group name. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • start: The starting index of the returned groups.
      • limit: The maximum number of groups to return per page. Note, this may be restricted by fixed system limits.
      • accessType: The group permission level for which to filter results.

    • getHistoryForContent

      @Deprecated public CompletableFuture<ContentHistory> getHistoryForContent(Consumer<GetHistoryForContentOperationSpec> spec)
      Veraltet.
      Get content history

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns the most recent update for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its history.
      • expand: A multi-value parameter indicating which properties of the content history to expand. Maximum sub-expansions allowed is 8. - lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - previousVersion returns information about the update prior to the current content update. For this method, it contains the same information as lastUpdated. - contributors returns all of the users who have contributed to the content. - nextVersion This parameter is not used for this method.

    • getIndividualGroupRestrictionStatusByGroupId

      public CompletableFuture<Void> getIndividualGroupRestrictionStatusByGroupId(Consumer<GetIndividualGroupRestrictionStatusByGroupIdOperationSpec> spec)
      Get content restriction status for group

      Returns whether the specified content restriction applies to a group. For example, if a page with id=123 has a read restriction for the 123456 group id, the following request will return true: /wiki/rest/api/content/123/restriction/byOperation/read/byGroupId/123456 Note that a response of true does not guarantee that the group can view the page, as it does not account for account-inherited restrictions, space permissions, or even product access. For more information, see [Confluence permissions](https://confluence.atlassian.com/x/_AozKw). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupId: The id of the group to be queried for whether the content restriction applies to it.

    • getLabelsForContent

      @Deprecated public CompletableFuture<LabelArray> getLabelsForContent(Consumer<GetLabelsForContentOperationSpec> spec)
      Veraltet.
      Get labels for content

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns the labels on a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space and permission to view the content if it is a page. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its labels.
      • prefix: Filters the results to labels with the specified prefix. If this parameter is not specified, then labels with any prefix will be returned. - global prefix is used by default when a user adds a label via the UI. - my prefix can be explicitly added by a user when adding a label via the UI, e.g. 'my:example-label'. Also, when a page is selected as a favourite, the 'my:favourite' label is automatically added. - team can used when adding labels via [Add labels to content](#api-content-id-label-post) but is not used in the UI.
      • start: The starting index of the returned labels.
      • limit: The maximum number of labels to return per page. Note, this may be restricted by fixed system limits.

    • getLabelsForSpace

      public CompletableFuture<LabelArray> getLabelsForSpace(Consumer<GetLabelsForSpaceOperationSpec> spec)
      Get Space Labels

      Returns a list of labels associated with a space. Can provide a prefix as well as other filters to select different types of labels. Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to get labels for.
      • prefix: Filters the results to labels with the specified prefix. If this parameter is not specified, then labels with any prefix will be returned. - global prefix is used by labels that are on content within the provided space. - my prefix can be explicitly added by a user when adding a label via the UI, e.g. 'my:example-label'. - team prefix is used for labels applied to the space.
      • start: The starting index of the returned labels.
      • limit: The maximum number of labels to return per page. Note, this may be restricted by fixed system limits.

    • getLookAndFeelSettings

      public CompletableFuture<LookAndFeelSettings> getLookAndFeelSettings(Consumer<GetLookAndFeelSettingsOperationSpec> spec)
      Get look and feel settings

      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. The look and feel settings for a space can be inherited from the global look and feel settings or provided by a theme. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: None Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space for which the look and feel settings will be returned. If this is not set, only the global look and feel settings are returned.

    • getMacroBodyByMacroId

      public CompletableFuture<MacroInstance> getMacroBodyByMacroId(Consumer<GetMacroBodyByMacroIdOperationSpec> spec)
      Get macro body by macro ID

      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. About the macro ID: When a macro is created in a new version of content, Confluence will generate a random ID for it, unless an ID is specified (by an app). The macro ID will look similar to this: '50884bd9-0cb8-41d5-98be-f80943c14f96'. The ID is then persisted as new versions of content are created, and is only modified by Confluence if there are conflicting IDs. Note, to preserve backwards compatibility this resource will also match on the hash of the macro body, even if a macro ID is found. This check will eventually become redundant, as macro IDs are generated for pages and transparently propagate out to all instances. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content that the macro is in. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID for the content that contains the macro.
      • version: The version of the content that contains the macro. Specifying 0 as the version will return the macro body for the latest content version.
      • macroId: The ID of the macro. This is usually passed by the app that the macro is in. Otherwise, find the macro ID by querying the desired content and version, then expanding the body in storage format. For example, '/content/196611/version/7?expand=content.body.storage'.

    • getMembersByQueryParam

      @Deprecated public CompletableFuture<UserArray> getMembersByQueryParam(Consumer<GetMembersByQueryParamOperationSpec> spec)
      Veraltet.
      Get group members

      Returns the users that are members of a group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: The name of the group to be queried for its members.
      • start: The starting index of the returned users.
      • limit: The maximum number of users to return per page. Note, this is restricted by fixed system limit of 200 which is to say if the limit parameter exceeds 200, this API will return a maximum of 200 users per page.
      • shouldReturnTotalSize: Whether to include total size parameter in the results. Note, fetching total size property is an expensive operation; use it if your use case needs this value.
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do. - personalSpace returns the user's personal space, if it exists. - isExternalCollaborator returns whether the user is an external collaborator user.

    • getModules

      public CompletableFuture<ConnectModules> getModules()
      Get modules

      Returns all modules registered dynamically by the calling app. **[Permissions](#permissions) required:** Only Connect apps can make this request.

    • getPrivacyUnsafeUserEmail

      public CompletableFuture<AccountIdEmailRecord> getPrivacyUnsafeUserEmail(Consumer<GetPrivacyUnsafeUserEmailOperationSpec> spec)
      Get user email address

      Returns a user's email address. This API is only available to apps approved by Atlassian, according to these [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • accountId: The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192. Required.

    • getPrivacyUnsafeUserEmailBulk

      public CompletableFuture<List<AccountIdEmailRecord>> getPrivacyUnsafeUserEmailBulk(Consumer<GetPrivacyUnsafeUserEmailBulkOperationSpec> spec)
      Get user email addresses in batch

      Returns user email addresses for a set of accountIds. This API is only available to apps approved by Atlassian, according to these [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603). Any accounts which are not available will not be included in the result. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • accountId: The account IDs of the users.

    • getRelationship

      public CompletableFuture<Relation> getRelationship(Consumer<GetRelationshipOperationSpec> spec)
      Find relationship from source to target

      Find whether a particular type of relationship exists from a source entity to a target entity. Note, relationships are one way. For example, you can use this method to find whether the current user has selected a particular page as a favorite (i.e. 'save for later'): GET /wiki/rest/api/relation/favourite/from/user/current/to/content/123 **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view both the target entity and source entity. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • relationName: The name of the relationship. This method supports the 'favourite' (i.e. 'save for later') relationship as well as any other relationship types created via [Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put).
      • sourceType: The source entity type of the relationship. This must be 'user', if the relationName is 'favourite'.
      • sourceKey: - The identifier for the source entity: - If sourceType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details. - If sourceType is 'content', then specify the content ID. - If sourceType is 'space', then specify the space key.
      • targetType: The target entity type of the relationship. This must be 'space' or 'content', if the relationName is 'favourite'.
      • targetKey: The identifier for the target entity: - If targetType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details. - If targetType is 'content', then specify the content ID. - If targetType is 'space', then specify the space key.
      • sourceStatus: The status of the source. This parameter is only used when the sourceType is 'content'.
      • targetStatus: The status of the target. This parameter is only used when the targetType is 'content'.
      • sourceVersion: The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.
      • targetVersion: The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.
      • expand: A multi-value parameter indicating which properties of the response object to expand. - relationData returns information about the relationship, such as who created it and when it was created. - source returns the source entity. - target returns the target entity.

    • getRestrictions

      public CompletableFuture<ContentRestrictionArray> getRestrictions(Consumer<GetRestrictionsOperationSpec> spec)
      Get restrictions

      Returns the restrictions on a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its restrictions.
      • expand: A multi-value parameter indicating which properties of the content restrictions to expand. By default, the following objects are expanded: restrictions.user, restrictions.group. - restrictions.user returns the piece of content that the restrictions are applied to. - restrictions.group returns the piece of content that the restrictions are applied to. - content returns the piece of content that the restrictions are applied to.
      • start: The starting index of the users and groups in the returned restrictions.
      • limit: The maximum number of users and the maximum number of groups, in the returned restrictions, to return per page. Note, this may be restricted by fixed system limits.

    • getRestrictionsByOperation

      public CompletableFuture<Map<String,GetRestrictionsByOperation200ResponseValue>> getRestrictionsByOperation(Consumer<GetRestrictionsByOperationOperationSpec> spec)
      Get restrictions by operation

      Returns restrictions on a piece of content by operation. This method is similar to [Get restrictions](#api-content-id-restriction-get) except that the operations are properties of the return object, rather than items in a results array. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its restrictions.
      • expand: A multi-value parameter indicating which properties of the content restrictions to expand. - restrictions.user returns the piece of content that the restrictions are applied to. Expanded by default. - restrictions.group returns the piece of content that the restrictions are applied to. Expanded by default. - content returns the piece of content that the restrictions are applied to.

    • getRestrictionsForOperation

      public CompletableFuture<ContentRestriction> getRestrictionsForOperation(Consumer<GetRestrictionsForOperationOperationSpec> spec)
      Get restrictions for operation

      Returns the restictions on a piece of content for a given operation (read or update). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its restrictions.
      • operationKey: The operation type of the restrictions to be returned.
      • expand: A multi-value parameter indicating which properties of the content restrictions to expand. - restrictions.user returns the piece of content that the restrictions are applied to. Expanded by default. - restrictions.group returns the piece of content that the restrictions are applied to. Expanded by default. - content returns the piece of content that the restrictions are applied to.
      • start: The starting index of the users and groups in the returned restrictions.
      • limit: The maximum number of users and the maximum number of groups, in the returned restrictions, to return per page. Note, this may be restricted by fixed system limits.

    • getRetentionPeriod

      public CompletableFuture<RetentionPeriod> getRetentionPeriod()
      Get retention period

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [read:audit-log:confluence]

    • getSpace

      @Deprecated public CompletableFuture<Space> getSpace(Consumer<GetSpaceOperationSpec> spec)
      Veraltet.
      Get space

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns a space. This includes information like the name, description, and permissions, but not the content in the space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space. Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be returned.
      • expand: A multi-value parameter indicating which properties of the spaces to expand, where: - settings returns the settings for the space, similar to [Get space settings](#api-space-spaceKey-settings-get). - metadata returns the space metadata. - metadata.labels returns the space labels, which are used to categorize the space. - operations returns the operations for a space, which are used when setting permissions. - lookAndFeel returns information about the look and feel of the space, including the color scheme. - permissions returns the permissions for the space. Note that this may return permissions for deleted groups, because deleting a group doesn't remove associated space permissions. - icon returns information about space icon. - description returns the description of the space. - description.plain returns the description of the space, the plain format. - description.view returns the description of the space, the view format. - theme returns information about the space theme. - homepage returns information about the space homepage. - history returns information about the history of the space.

    • getSpaceContentStates

      public CompletableFuture<List<ContentState>> getSpaceContentStates(Consumer<GetSpaceContentStatesOperationSpec> spec)
      Get space suggested content states

      Get content states that are suggested in the space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Space view permission Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content state settings.

    • getSpaceProperties

      @Deprecated public CompletableFuture<SpacePropertyArray> getSpaceProperties(Consumer<GetSpacePropertiesOperationSpec> spec)
      Veraltet.
      Get space properties

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns all properties for the given space. Space properties are a key-value storage associated with a space. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘View’ permission for the space. Authentication - Required Scopes: [read:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its properties.
      • expand: A multi-value parameter indicating which properties of the space property to expand. By default, the version object is expanded. - version returns information about the version of the content. - space returns the space that the properties are in.
      • start: The starting index of the returned objects.
      • limit: The maximum number of properties to return per page. Note, this may be restricted by fixed system limits.

    • getSpaceProperty

      @Deprecated public CompletableFuture<SpaceProperty> getSpaceProperty(Consumer<GetSpacePropertyOperationSpec> spec)
      Veraltet.
      Get space property

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns a space property. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘View’ permission for the space. Authentication - Required Scopes: [read:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space that the property is in.
      • key: The key of the space property.
      • expand: A multi-value parameter indicating which properties of the space property to expand. By default, the version object is expanded. - version returns information about the version of the content. - space returns the space that the properties are in.

    • getSpaceSettings

      public CompletableFuture<SpaceSettings> getSpaceSettings(Consumer<GetSpaceSettingsOperationSpec> spec)
      Get space settings

      Returns the settings of a space. Currently only the routeOverrideEnabled setting can be returned. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space. Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its settings.

    • getSpaceTheme

      public CompletableFuture<Theme> getSpaceTheme(Consumer<GetSpaceThemeOperationSpec> spec)
      Get space theme

      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. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘View’ permission for the space. Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its theme.

    • getSpaces

      @Deprecated public CompletableFuture<SpaceArray> getSpaces(Consumer<GetSpacesOperationSpec> spec)
      Veraltet.
      Get spaces

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns all spaces. The returned spaces are ordered alphabetically in ascending order by space key. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Note, the returned list will only contain spaces that the current user has permission to view. Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be returned. To return multiple spaces, specify this parameter multiple times with different values.
      • spaceId: The id of the space to be returned. To return multiple spaces, specify this parameter multiple times with different values.
      • type: Filter the results to spaces based on their type.
      • status: Filter the results to spaces based on their status.
      • label: Filter the results to spaces based on their label.
      • favourite: Filter the results to the favourite spaces of the user specified by favouriteUserKey. Note, 'favourite' spaces are also known as 'saved for later' spaces.
      • favouriteUserKey: The userKey of the user, whose favourite spaces are used to filter the results when using the favourite parameter. Leave blank for the current user. Use [Get user](#api-user-get) to get the userKey for a user.
      • expand: A multi-value parameter indicating which properties of the spaces to expand, where: - settings returns the settings for the space, similar to [Get space settings](#api-space-spaceKey-settings-get). - metadata returns the space metadata. - metadata.labels returns the space labels, which are used to categorize the space. - operations returns the operations for a space, which are used when setting permissions. - lookAndFeel returns information about the look and feel of the space, including the color scheme. - permissions returns the permissions for the space. Note that this may return permissions for deleted groups, because deleting a group doesn't remove associated space permissions. - icon returns information about space icon. - description returns the description of the space. - description.plain returns the description of the space, the plain format. - description.view returns the description of the space, the view format. - theme returns information about the space theme. - homepage returns information about the space homepage. - history returns information about the history of the space.
      • start: The starting index of the returned spaces.
      • limit: The maximum number of spaces to return per page. Note, this may be restricted by fixed system limits.

    • getSystemInfo

      public CompletableFuture<SystemInfoEntity> getSystemInfo()
      Get system info

      Returns the system information for the Confluence Cloud tenant. This information is used by Atlassian. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [manage:confluence-configuration]

    • getTask

      public CompletableFuture<LongTaskStatusWithLinks> getTask(Consumer<GetTaskOperationSpec> spec)
      Get long-running task

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-space.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the task.

    • getTaskById

      @Deprecated public CompletableFuture<Task> getTaskById(Consumer<GetTaskByIdOperationSpec> spec)
      Veraltet.
      Get inline task based on global ID

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns inline task based on the global ID. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content associated with the task. Authentication - Required Scopes: [read:inlinetask:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • inlineTaskId: Global ID of the inline task

    • getTaskUpdate

      public CompletableFuture<ContentStateBulkSetTaskUpdate> getTaskUpdate(Consumer<GetTaskUpdateOperationSpec> spec)
      Get update on long running task for setting of content state.

      Get Status of long running task that was previously created to set or remove content states from content. User must first create a task by passing in details to /wiki/rest/api/content-states PUT or DELETE endpoints. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required** Must have created long running task

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • taskId: taskId returned by put or delete requests to /wiki/rest/api/content-states

    • getTasks

      public CompletableFuture<LongTaskStatusArray> getTasks(Consumer<GetTasksOperationSpec> spec)
      Get long-running tasks

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:content.metadata:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • start: The starting index of the returned tasks.
      • limit: The maximum number of tasks to return per page. Note, this may be restricted by fixed system limits.

    • getTheme

      public CompletableFuture<Theme> getTheme(Consumer<GetThemeOperationSpec> spec)
      Get theme

      Returns a theme. This includes information about the theme name, description, and icon. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: None Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • themeKey: The key of the theme to be returned.

    • getThemes

      public CompletableFuture<ThemeArray> getThemes(Consumer<GetThemesOperationSpec> spec)
      Get themes

      Returns all [admin-driven themes](https://developer.atlassian.com/cloud/confluence/create-a-confluence-theme/), not including the default theme. Note that this API only applies to themes set for an entire space or site by the admin. User-driven theming controls (Light, Dark, and match browser) are an unrelated feature. Admin-driven themes will override user-driven themes. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: None Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • start: The starting index of the returned themes.
      • limit: The maximum number of themes to return per page. Note, this may be restricted by fixed system limits.

    • getUser

      public CompletableFuture<User> getUser(Consumer<GetUserOperationSpec> spec)
      Get user

      Returns a user. This includes information about the user, such as the display name, account ID, profile picture, and more. The information returned may be restricted by the user's profile visibility settings. **Note:** to add, edit, or delete users in your organization, see the [user management REST API](/cloud/admin/user-management/about/). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-user]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations that the user is allowed to do. - personalSpace returns the user's personal space, if it exists. - isExternalCollaborator returns whether the user is an external collaborator user.

    • getUserProperties

      public CompletableFuture<UserPropertyKeyArray> getUserProperties(Consumer<GetUserPropertiesOperationSpec> spec)
      Get user properties

      Returns the properties for a user as list of property keys. For more information about user properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). Note, these properties stored against a user are on a Confluence site level and not space/content level. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:user.property:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • userId: The account ID of the user to be queried for its properties.
      • start: The starting index of the returned properties.
      • limit: The maximum number of properties to return per page. Note, this may be restricted by fixed system limits.

    • getUserProperty

      public CompletableFuture<UserProperty> getUserProperty(Consumer<GetUserPropertyOperationSpec> spec)
      Get user property

      Returns the property corresponding to key for a user. For more information about user properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). Note, these properties stored against a user are on a Confluence site level and not space/content level. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:user.property:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • userId: The account ID of the user to be queried for its properties.
      • key: The key of the user property.

    • getViewers

      public CompletableFuture<GetViewers200Response> getViewers(Consumer<GetViewersOperationSpec> spec)
      Get viewers

      Get the total number of distinct viewers a piece of content has. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentId: The ID of the content to get the viewers for.
      • fromDate: The number of views for the content since the date.

    • getViews

      public CompletableFuture<GetViews200Response> getViews(Consumer<GetViewsOperationSpec> spec)
      Get views

      Get the total number of views a piece of content has. Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentId: The ID of the content to get the views for.
      • fromDate: The number of views for the content since the date.

    • getWatchersForSpace

      public CompletableFuture<SpaceWatchArray> getWatchersForSpace(Consumer<GetWatchersForSpaceOperationSpec> spec)
      Get space watchers

      Returns a list of watchers of a space Authentication - Required Scopes: [read:watcher:confluence, read:user:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to get watchers.
      • start: The start point of the collection to return.
      • limit: The limit of the number of items to return, this may be restricted by fixed system limits.

    • getWatchesForPage

      public CompletableFuture<WatchArray> getWatchesForPage(Consumer<GetWatchesForPageOperationSpec> spec)
      Get watches for page

      Returns the watches for a page. A user that watches a page will receive receive notifications when the page is updated. If you want to manage watches for a page, use the following user methods: - [Get content watch status for user](#api-user-watch-content-contentId-get) - [Add content watch](#api-user-watch-content-contentId-post) - [Remove content watch](#api-user-watch-content-contentId-delete) **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its watches.
      • start: The starting index of the returned watches.
      • limit: The maximum number of watches to return per page. Note, this may be restricted by fixed system limits.

    • getWatchesForSpace

      public CompletableFuture<SpaceWatchArray> getWatchesForSpace(Consumer<GetWatchesForSpaceOperationSpec> spec)
      Get watches for space

      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. If you want to manage watches for a space, use the following user methods: - [Get space watch status for user](#api-user-watch-space-spaceKey-get) - [Add space watch](#api-user-watch-space-spaceKey-post) - [Remove space watch](#api-user-watch-space-spaceKey-delete) **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be queried for its watches.
      • start: The starting index of the returned watches.
      • limit: The maximum number of watches to return per page. Note, this may be restricted by fixed system limits.

    • isWatchingLabel

      public CompletableFuture<UserWatch> isWatchingLabel(Consumer<IsWatchingLabelOperationSpec> spec)
      Get label watch status

      Returns whether a user is watching a label. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • labelName: The name of the label to be queried for whether the specified user is watching it.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • isWatchingSpace

      public CompletableFuture<UserWatch> isWatchingSpace(Consumer<IsWatchingSpaceOperationSpec> spec)
      Get space watch status

      Returns whether a user is watching a space. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [read:confluence-content.summary]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for whether the specified user is watching it.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • movePage

      public CompletableFuture<MovePage200Response> movePage(Consumer<MovePageOperationSpec> spec)
      Move a page to a new location relative to a target page

      Move a page to a new location relative to a target page: * before - move the page under the same parent as the target, before the target in the list of children * after - move the page under the same parent as the target, after the target in the list of children * append - move the page to be a child of the target Caution: This API can move pages to the top level of a space. Top-level pages are difficult to find in the UI because they do not show up in the page tree display. To avoid this, never use before or after positions when the targetId is a top-level page. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • pageId: The ID of the page to be moved
      • position: The position to move the page to relative to the target page: * before - move the page under the same parent as the target, before the target in the list of children * after - move the page under the same parent as the target, after the target in the list of children * append - move the page to be a child of the target
      • targetId: The ID of the target page for this operation

    • publishLegacyDraft

      public CompletableFuture<Content> publishLegacyDraft(Consumer<PublishLegacyDraftOperationSpec> spec)
      Publish legacy draft

      Publishes a legacy draft of a page created from a blueprint. Legacy drafts will eventually be removed in favor of shared drafts. For now, this method works the same as [Publish shared draft](#api-content-blueprint-instance-draftId-put). By default, the following objects are expanded: body.storage, history, space, version, ancestors. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the draft and 'Add' permission for the space that the content will be created in. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • draftId: The ID of the draft page that was created from a blueprint. You can find the draftId in the Confluence application by opening the draft page and checking the page URL.
      • body:
      • status: The status of the content to be updated, i.e. the draft. This is set to 'draft' by default, so you shouldn't need to specify it.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.

    • publishSharedDraft

      public CompletableFuture<Content> publishSharedDraft(Consumer<PublishSharedDraftOperationSpec> spec)
      Publish shared draft

      Publishes a shared draft of a page created from a blueprint. By default, the following objects are expanded: body.storage, history, space, version, ancestors. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the draft and 'Add' permission for the space that the content will be created in. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • draftId: The ID of the draft page that was created from a blueprint. You can find the draftId in the Confluence application by opening the draft page and checking the page URL.
      • body:
      • status: The status of the content to be updated, i.e. the draft. This is set to 'draft' by default, so you shouldn't need to specify it.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.

    • registerModules

      public CompletableFuture<Void> registerModules(Consumer<RegisterModulesOperationSpec> spec)
      Register modules

      Registers a list of modules. For the list of modules that support dynamic registration, see [Dynamic modules](https://developer.atlassian.com/cloud/confluence/dynamic-modules/). **[Permissions](#permissions) required:** Only Connect apps can make this request.

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body:

    • removeContentState

      public CompletableFuture<ContentStateResponse> removeContentState(Consumer<RemoveContentStateOperationSpec> spec)
      Removes the content state of a content and publishes a new version.

      Removes the content state of the content specified and creates a new version (publishes the content without changing the body) of the content with the new status. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The Id of the content whose content state is to be set.
      • status: status of content state from which to delete state. Can be draft or archived

    • removeContentWatcher

      public CompletableFuture<Void> removeContentWatcher(Consumer<RemoveContentWatcherOperationSpec> spec)
      Remove content watcher

      Removes a user as a watcher from a piece of content. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • xAtlassianToken: Note, you must add header when making a request, as this operation has XSRF protection.
      • contentId: The ID of the content to remove the watcher from.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • removeGroup

      @Deprecated public CompletableFuture<Void> removeGroup(Consumer<RemoveGroupOperationSpec> spec)
      Veraltet.
      Delete user group

      Delete user group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: Name of the group to delete.

    • removeGroupById

      public CompletableFuture<Void> removeGroupById(Consumer<RemoveGroupByIdOperationSpec> spec)
      Delete user group

      Delete user group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: Id of the group to delete.

    • removeGroupFromContentRestriction

      public CompletableFuture<Void> removeGroupFromContentRestriction(Consumer<RemoveGroupFromContentRestrictionOperationSpec> spec)
      Remove group from content restriction

      Removes a group from a content restriction. That is, remove read or update permission for the group for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupId: The id of the group to remove from the content restriction.

    • removeGroupFromContentRestrictionById

      @Deprecated public CompletableFuture<Void> removeGroupFromContentRestrictionById(Consumer<RemoveGroupFromContentRestrictionByIdOperationSpec> spec)
      Veraltet.
      Remove group from content restriction

      Deprecated, use [Remove group from content restriction by groupId](https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-restrictions/#api-wiki-rest-api-content-id-restriction-byoperation-operationkey-user-delete). Removes a group from a content restriction. That is, remove read or update permission for the group for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • groupName: The name of the group to remove from the content restriction.

    • removeLabelFromContent

      public CompletableFuture<Void> removeLabelFromContent(Consumer<RemoveLabelFromContentOperationSpec> spec)
      Remove label from content

      Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove label from content using query parameter](#api-content-id-label-delete) except that the label name is specified via a path parameter. Use this method if the label name does not have "/" characters, as the path parameter does not accept "/" characters for security reasons. Otherwise, use [Remove label from content using query parameter](#api-content-id-label-delete). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the label will be removed from.
      • label: The name of the label to be removed.

    • removeLabelFromContentUsingQueryParameter

      public CompletableFuture<Void> removeLabelFromContentUsingQueryParameter(Consumer<RemoveLabelFromContentUsingQueryParameterOperationSpec> spec)
      Remove label from content using query parameter

      Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove label from content](#api-content-id-label-label-delete) except that the label name is specified via a query parameter. Use this method if the label name has "/" characters, as [Remove label from content using query parameter](#api-content-id-label-delete) does not accept "/" characters for the label name. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the label will be removed from.
      • name: The name of the label to be removed.

    • removeLabelWatcher

      public CompletableFuture<Void> removeLabelWatcher(Consumer<RemoveLabelWatcherOperationSpec> spec)
      Remove label watcher

      Removes a user as a watcher from a label. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • labelName: The name of the label to remove the watcher from.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • removeMemberFromGroup

      @Deprecated public CompletableFuture<Void> removeMemberFromGroup(Consumer<RemoveMemberFromGroupOperationSpec> spec)
      Veraltet.
      Remove member from group

      Remove user as a member from a group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • name: Name of the group whose membership is updated.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • removeMemberFromGroupByGroupId

      public CompletableFuture<Void> removeMemberFromGroupByGroupId(Consumer<RemoveMemberFromGroupByGroupIdOperationSpec> spec)
      Remove member from group using group id

      Remove user as a member from a group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin. Authentication - Required Scopes: [write:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: Id of the group whose membership is updated.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • removeModules

      public CompletableFuture<Void> removeModules(Consumer<RemoveModulesOperationSpec> spec)
      Remove modules

      Remove all or a list of modules registered by the calling app. **[Permissions](#permissions) required:** Only Connect apps can make this request.

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • moduleKey: The key of the module to remove. To include multiple module keys, provide multiple copies of this parameter. For example, moduleKey=dynamic-attachment-entity-property&amp;moduleKey=dynamic-select-field. Nonexistent keys are ignored.

    • removePermission

      public CompletableFuture<Void> removePermission(Consumer<RemovePermissionOperationSpec> spec)
      Remove a space permission

      Removes a space permission. Note that removing Read Space permission for a user or group will remove all the space permissions for that user or group. Note: Apps cannot access this REST resource - including when utilizing user impersonation. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:space.permission:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to be queried for its content.
      • id: Id of the permission to be deleted.

    • removeSpaceWatch

      public CompletableFuture<Void> removeSpaceWatch(Consumer<RemoveSpaceWatchOperationSpec> spec)
      Remove space watch

      Removes a user as a watcher from a space. Choose the user by doing one of the following: - Specify a user via a query parameter: Use the accountId to identify the user. - Do not specify a user: The currently logged-in user will be used. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to remove the watcher from.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • removeTemplate

      public CompletableFuture<Void> removeTemplate(Consumer<RemoveTemplateOperationSpec> spec)
      Remove template

      Deletes a template. This results in different actions depending on the type of template: - If the template is a content template, it is deleted. - If the template is a modified space-level blueprint template, it reverts to the template inherited from the global-level blueprint template. - If the template is a modified global-level blueprint template, it reverts to the default global-level blueprint template. Note, unmodified blueprint templates cannot be deleted. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space to delete a space template or 'Confluence Administrator' global permission to delete a global template. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • contentTemplateId: The ID of the template to be deleted.

    • removeUserFromContentRestriction

      public CompletableFuture<Void> removeUserFromContentRestriction(Consumer<RemoveUserFromContentRestrictionOperationSpec> spec)
      Remove user from content restriction

      Removes a group from a content restriction. That is, remove read or update permission for the group for a piece of content. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the restriction applies to.
      • operationKey: The operation that the restriction applies to.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use accountId instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192.

    • resetLookAndFeelSettings

      public CompletableFuture<Void> resetLookAndFeelSettings(Consumer<ResetLookAndFeelSettingsOperationSpec> spec)
      Reset look and feel settings

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space for which the look and feel settings will be reset. If this is not set, the global look and feel settings will be reset.

    • resetSpaceTheme

      public CompletableFuture<Void> resetSpaceTheme(Consumer<ResetSpaceThemeOperationSpec> spec)
      Reset space theme

      Resets the space theme. This means that the space will inherit the global look and feel settings **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to reset the theme for.

    • restoreContentVersion

      public CompletableFuture<Version> restoreContentVersion(Consumer<RestoreContentVersionOperationSpec> spec)
      Restore content version

      Restores a historical version to be the latest version. That is, a new version is created with the content of the historical version. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content for which the history will be restored.
      • body: The content version to be restored.
      • expand: A multi-value parameter indicating which properties of the content to expand. By default, the content object is expanded. - collaborators returns the users that collaborated on the version. - content returns the content for the version.

    • searchByCQL

      public CompletableFuture<SearchPageResponseSearchResult> searchByCQL(Consumer<SearchByCQLOperationSpec> spec)
      Search content

      Searches for content using the [Confluence Query Language (CQL)](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/). **Note that CQL input queries submitted through the /wiki/rest/api/search endpoint no longer support user-specific fields like user, user.fullname, user.accountid, and user.userkey.** See this [deprecation notice](https://developer.atlassian.com/cloud/confluence/deprecation-notice-search-api/) for more details. Example initial call: /wiki/rest/api/search?cql=type=page&amp;limit=25 Example response: ` { "results": [ { ... }, { ... }, ... { ... } ], "limit": 25, "size": 25, ... "_links": { "base": "&lt;url&gt;", "context": "&lt;url&gt;", "next": "/rest/api/search?cql=type=page&limit=25&cursor=raNDoMsTRiNg", "self": "&lt;url&gt;" } } ` When additional results are available, returns next and prev URLs to retrieve them in subsequent calls. The URLs each contain a cursor that points to the appropriate set of results. Use limit to specify the number of results returned in each call. Example subsequent call (taken from example response): /wiki/rest/api/search?cql=type=page&amp;limit=25&amp;cursor=raNDoMsTRiNg The response to this will have a prev URL similar to the next in the example response. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the entities. Note, only entities that the user has permission to view will be returned. Authentication - Required Scopes: [search:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • cql: The CQL query to be used for the search. See [Advanced Searching using CQL](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/) for instructions on how to build a CQL query.
      • cqlcontext: The space, content, and content status to execute the search against. - spaceKey Key of the space to search against. Optional. - contentId ID of the content to search against. Optional. Must be in the space specified by spaceKey. - contentStatuses Content statuses to search against. Optional. Specify these values in an object. For example, cqlcontext={%22spaceKey%22:%22TEST%22, %22contentId%22:%22123%22}
      • cursor: Pointer to a set of search results, returned as part of the next or prev URL from the previous search call.
      • next:
      • prev:
      • limit: The maximum number of content objects to return per page. Note, this may be restricted by fixed system limits.
      • start: The start point of the collection to return
      • includeArchivedSpaces: Whether to include content from archived spaces in the results.
      • excludeCurrentSpaces: Whether to exclude current spaces and only show archived spaces.
      • excerpt: The excerpt strategy to apply to the result
      • sitePermissionTypeFilter: Filters users by permission type. Use none to default to licensed users, externalCollaborator for external/guest users, and all to include all permission types.
      • _u:
      • expand:

    • searchContentByCQL

      public CompletableFuture<ContentArray> searchContentByCQL(Consumer<SearchContentByCQLOperationSpec> spec)
      Search content by CQL

      Returns the list of content that matches a Confluence Query Language (CQL) query. For information on CQL, see: [Advanced searching using CQL](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/). Example initial call: /wiki/rest/api/content/search?cql=type=page&amp;limit=25 Example response: ` { "results": [ { ... }, { ... }, ... { ... } ], "limit": 25, "size": 25, ... "_links": { "base": "&lt;url&gt;", "context": "&lt;url&gt;", "next": "/rest/api/content/search?cql=type=page&limit=25&cursor=raNDoMsTRiNg", "self": "&lt;url&gt;" } } ` When additional results are available, returns next and prev URLs to retrieve them in subsequent calls. The URLs each contain a cursor that points to the appropriate set of results. Use limit to specify the number of results returned in each call. Example subsequent call (taken from example response): /wiki/rest/api/content/search?cql=type=page&amp;limit=25&amp;cursor=raNDoMsTRiNg The response to this will have a prev URL similar to the next in the example response. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Only content that the user has permission to view will be returned. Authentication - Required Scopes: [search:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • cql: The CQL string that is used to find the requested content.
      • cqlcontext: The space, content, and content status to execute the search against. Specify this as an object with the following properties: - spaceKey Key of the space to search against. Optional. - contentId ID of the content to search against. Optional. Must be in the space spacified by spaceKey. - contentStatuses Content statuses to search against. Optional.
      • expand: A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      • cursor: Pointer to a set of search results, returned as part of the next or prev URL from the previous search call.
      • limit: The maximum number of content objects to return per page. Note, this may be restricted by fixed system limits.

    • searchGroups

      public CompletableFuture<GroupArrayWithLinks> searchGroups(Consumer<SearchGroupsOperationSpec> spec)
      Search groups by partial query

      Get search results of groups by partial query provided. Authentication - Required Scopes: [read:confluence-groups]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • query: the search term used to query results.
      • start: The starting index of the returned groups.
      • limit: The maximum number of groups to return per page. Note, this is restricted to a maximum limit of 200 groups.
      • shouldReturnTotalSize: Whether to include total size parameter in the results. Note, fetching total size property is an expensive operation; use it if your use case needs this value.

    • searchTasks

      @Deprecated public CompletableFuture<TaskPageResponse> searchTasks(Consumer<SearchTasksOperationSpec> spec)
      Veraltet.
      Get inline tasks based on search parameters

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Returns inline tasks based on the search query. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Only tasks in contents that the user has permission to view are returned. Authentication - Required Scopes: [read:confluence-content.all]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • start: The starting offset for the results.
      • limit: The number of results to be returned.
      • spaceKey: The space key of a space. Multiple space keys can be specified.
      • pageId: The page id of a page. Multiple page ids can be specified.
      • assignee: Account ID of a user to whom a task is assigned. Multiple users can be specified.
      • creator: Account ID of a user to who created a task. Multiple users can be specified.
      • completedUser: Account ID of a user who completed a task. Multiple users can be specified.
      • duedateFrom: Start of date range based on due dates (inclusive).
      • duedateTo: End of date range based on due dates (inclusive).
      • createdateFrom: Start of date range based on create dates (inclusive).
      • createdateTo: End of date range based on create dates (inclusive).
      • completedateFrom: Start of date range based on complete dates (inclusive).
      • completedateTo: End of date range based on complete dates (inclusive).
      • status: The status of the task. (checked/unchecked)

    • searchUser

      public CompletableFuture<SearchPageResponseSearchResult> searchUser(Consumer<SearchUserOperationSpec> spec)
      Search users

      Searches for users using user-specific queries from the [Confluence Query Language (CQL)](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/). Note that CQL input queries submitted through the /wiki/rest/api/search/user endpoint only support user-specific fields like user, user.fullname, user.accountid, and user.userkey. Note that some user fields may be set to null depending on the user's privacy settings. These are: email, profilePicture, displayName, and timeZone. Authentication - Required Scopes: [read:content-details:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • cql: The CQL query to be used for the search. See [Advanced Searching using CQL](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/) for instructions on how to build a CQL query. Example queries: cql=type=user will return all users cql=user="1234" will return user with accountId "1234" You can also use IN, NOT IN, != operators cql=user IN ("12", "34") will return users with accountids "12" and "34" cql=user.fullname~jo will return users with nickname/full name starting with "jo" cql=user.accountid="123" will return user with accountId "123"
      • start: The starting index of the returned users.
      • limit: The maximum number of user objects to return per page. Note, this may be restricted by fixed system limits.
      • expand: A multi-value parameter indicating which properties of the user to expand. - operations returns the operations for the user, which are used when setting permissions. - personalSpace returns the personal space of the user.
      • sitePermissionTypeFilter: Filters users by permission type. Use none to default to licensed users, externalCollaborator for external/guest users, and all to include all permission types.

    • setContentState

      public CompletableFuture<ContentStateResponse> setContentState(Consumer<SetContentStateOperationSpec> spec)
      Set the content state of a content and publishes a new version of the content.

      Sets the content state of the content specified and creates a new version (publishes the content without changing the body) of the content with the new state. You may pass in either an id of a state, or the name and color of a desired new state. If all 3 are passed in, id will be used. If the name and color passed in already exist under the current user's existing custom states, the existing state will be reused. If custom states are disabled in the space of the content (which can be determined by getting the content state space settings of the content's space) then this set will fail. You may not remove a content state via this PUT request. You must use the DELETE method. A specified state is required in the body of this request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The Id of the content whose content state is to be set.
      • contentStateRestInput: Content state fields for state. Pass in id for an existing state, or new name and color for best matching existing state, or new state if allowed in space.
      • status: Status of content onto which state will be placed. If draft, then draft state will change. If current, state will be placed onto a new version of the content with same body as previous version.

    • setLookAndFeelSettings

      @Deprecated public CompletableFuture<String> setLookAndFeelSettings(Consumer<SetLookAndFeelSettingsOperationSpec> spec)
      Veraltet.
      Set look and feel settings

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The look and feel type to be set.
      • spaceKey: The key of the space for which the look and feel settings will be set. If this is not set, the global look and feel settings will be set.

    • setRetentionPeriod

      public CompletableFuture<RetentionPeriod> setRetentionPeriod(Consumer<SetRetentionPeriodOperationSpec> spec)
      Set retention period

      Sets the retention period for records in the audit log. The retention period can be set to a maximum of 1 year. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. Authentication - Required Scopes: [write:audit-log:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The updated retention period.

    • setSpaceTheme

      public CompletableFuture<Theme> setSpaceTheme(Consumer<SetSpaceThemeOperationSpec> spec)
      Set space theme

      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. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to set the theme for.
      • body:

    • updateAttachmentData

      public CompletableFuture<Content> updateAttachmentData(Consumer<UpdateAttachmentDataOperationSpec> spec)
      Update attachment data

      Updates the binary data of an attachment, given the attachment ID, and optionally the comment and the minor edit field. This method is essentially the same as [Create or update attachments](#api-content-id-child-attachment-put), except that it matches the attachment ID rather than the name. Note, you must set a X-Atlassian-Token: nocheck header on the request for this method, otherwise it will be blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data. The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client libraries have classes that make it easier to implement multipart posts, like the [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class provided by Apache HTTP Components. Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used in that part. In the case of this API endpoint, the comment body parameter should be sent with type=text/plain and charset=utf-8 values. This will force the charset to be UTF-8. Example: This curl command updates an attachment (id='att456') that is attached to a piece of content (id='123') with a comment and minorEdits=true. ` bash curl -D- \\ -u admin:admin \\ -X POST \\ -H 'X-Atlassian-Token: nocheck' \\ -F 'file=@"example.txt"' \\ -F 'minorEdit="true"' \\ -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \\ http://myhost/rest/api/content/123/child/attachment/att456/data ` **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-file]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the attachment is attached to.
      • attachmentId: The ID of the attachment to update.
      • _file: The relative location and name of the attachment to be added to the content.
      • minorEdit: If minorEdits is set to 'true', no notification email or activity stream will be generated when the attachment is added to the content.
      • comment: The comment for the attachment that is being added. If you specify a comment, then every file must have a comment and the comments must be in the same order as the files. Alternatively, don't specify any comments.

    • updateAttachmentProperties

      public CompletableFuture<Content> updateAttachmentProperties(Consumer<UpdateAttachmentPropertiesOperationSpec> spec)
      Update attachment properties

      Updates the attachment properties, i.e. the non-binary data of an attachment like the filename, media-type, comment, and parent container. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-file, write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the attachment is attached to.
      • attachmentId: The ID of the attachment to update.
      • body: The details of the attachment to be updated.

    • updateContent

      @Deprecated public CompletableFuture<Content> updateContent(Consumer<UpdateContentOperationSpec> spec)
      Veraltet.
      Update content

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). 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. Note, updating draft content is currently not supported. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to be updated.
      • content: The updated content.
      • status: The updated status of the content. Use this parameter to change the status of a piece of content without passing the entire request body.
      • conflictPolicy: The action that should be taken when conflicts are discovered. Only used when publishing a draft page.

    • updateContentProperty

      @Deprecated public CompletableFuture<ContentProperty> updateContentProperty(Consumer<UpdateContentPropertyOperationSpec> spec)
      Veraltet.
      Update content property

      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 [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content that the property belongs to.
      • key: The key of the property.
      • body: The content property being updated.

    • updateContentTemplate

      public CompletableFuture<ContentTemplate> updateContentTemplate(Consumer<UpdateContentTemplateOperationSpec> spec)
      Update content template

      Updates a content template. Note, blueprint templates cannot be updated via the REST API. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space to update a space template or 'Confluence Administrator' global permission to update a global template. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The updated content template.

    • updateLookAndFeel

      public CompletableFuture<LookAndFeelSelection> updateLookAndFeel(Consumer<UpdateLookAndFeelOperationSpec> spec)
      Select look and feel settings

      Sets the look and feel settings to the default (global) settings, the custom settings, or the current theme's settings for a space. The custom and theme settings can only be selected if there is already a theme set for a space. Note, the default space settings are inherited from the current global settings. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The look and feel type to be set.

    • updateLookAndFeelSettings

      public CompletableFuture<LookAndFeelWithLinks> updateLookAndFeelSettings(Consumer<UpdateLookAndFeelSettingsOperationSpec> spec)
      Update look and feel settings

      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. Note, if a theme is selected for a space, the space look and feel settings are provided by the theme and cannot be overridden. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [manage:confluence-configuration]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • body: The updated settings. All values for the settings must be included, regardless of whether they are being changed. One way to create the request body is to copy the settings from the response body of [Get look and feel settings](#api-settings-lookandfeel-get) and modify it as needed.
      • spaceKey: The key of the space for which the look and feel settings will be updated. If this is not set, the global look and feel settings will be updated.

    • updateRestrictions

      public CompletableFuture<ContentRestrictionArray> updateRestrictions(Consumer<UpdateRestrictionsOperationSpec> spec)
      Update restrictions

      Updates restrictions for a piece of content. This removes the existing restrictions and replaces them with the restrictions in the request. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to edit the content. Authentication - Required Scopes: [write:confluence-content]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The ID of the content to update restrictions for.
      • body: The updated restrictions for the content.
      • expand: A multi-value parameter indicating which properties of the content restrictions (returned in response) to expand. - restrictions.user returns the piece of content that the restrictions are applied to. Expanded by default. - restrictions.group returns the piece of content that the restrictions are applied to. Expanded by default. - content returns the piece of content that the restrictions are applied to.

    • updateSpace

      public CompletableFuture<Space> updateSpace(Consumer<UpdateSpaceOperationSpec> spec)
      Update space

      Updates the name, description, or homepage of a space. - For security reasons, permissions cannot be updated via the API and must be changed via the user interface instead. - Currently you cannot set space labels when updating a space. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space to update.
      • body: The updated space.

    • updateSpaceProperty

      @Deprecated public CompletableFuture<SpaceProperty> updateSpaceProperty(Consumer<UpdateSpacePropertyOperationSpec> spec)
      Veraltet.
      Update space property

      Deprecated, use [Confluence's v2 API](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/). Updates a space property. Note, you cannot update the key of a space property, only the value. **[Permissions required](https://confluence.atlassian.com/x/_AozKw)**: ‘Admin’ permission for the space. Authentication - Required Scopes: [write:confluence-props]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space that the property is in.
      • key: The key of the property to be updated.
      • body: The space property being updated.

    • updateSpaceSettings

      public CompletableFuture<SpaceSettings> updateSpaceSettings(Consumer<UpdateSpaceSettingsOperationSpec> spec)
      Update space settings

      Updates the settings for a space. Currently only the routeOverrideEnabled setting can be updated. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space. Authentication - Required Scopes: [write:confluence-space]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • spaceKey: The key of the space whose settings will be updated.
      • spaceSettingsUpdate: The space settings to update.

    • updateTaskById

      @Deprecated public CompletableFuture<Task> updateTaskById(Consumer<UpdateTaskByIdOperationSpec> spec)
      Veraltet.
      Update inline task given global ID

      Updates an inline tasks status given its global ID **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content associated with the task. Authentication - Required Scopes: [read:inlinetask:confluence, write:inlinetask:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • inlineTaskId: Global ID of the inline task to update
      • taskStatusUpdate: The updated task status.

    • updateUserProperty

      public CompletableFuture<Void> updateUserProperty(Consumer<UpdateUserPropertyOperationSpec> spec)
      Update user property

      Updates a property for the given user. Note, you cannot update the key of a user property, only the value. For more information about user properties, see [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). Note, these properties stored against a user are on a Confluence site level and not space/content level. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission). Authentication - Required Scopes: [write:user.property:confluence]

      Parameter:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • userId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, 384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192
      • key: The key of the user property.
      • body: The user property to be updated.