openapi: 3.1.0 info: title: Atlassian Admin Account Group API description: The Atlassian Admin API provides programmatic access to manage Atlassian organizations, users, domains, policies, and events. It enables administrators to automate organization management tasks, integrate with identity providers, and ensure appropriate access to Atlassian products. version: 1.0.0 contact: name: Atlassian Developer url: https://developer.atlassian.com/cloud/admin/ license: name: Atlassian Developer Terms url: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/ x-logo: url: https://wac-cdn.atlassian.com/assets/img/favicons/atlassian/favicon.png servers: - url: https://api.atlassian.com description: Atlassian Cloud API security: - bearerAuth: [] - oauth2: [] tags: - name: Group paths: /wiki/rest/api/group/by-name: get: tags: - Group summary: Atlassian Get Group description: 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). operationId: atlassianGetgroupbyqueryparam parameters: - name: name in: query description: 'The name of the group. This is the same as the group name shown in the Confluence administration console.' required: true schema: type: string responses: '200': description: Returned if the requested group is returned. content: application/json: schema: $ref: '#/components/schemas/Group' '403': description: 'Returned if the calling user does not have permission to view groups.' content: {} '404': description: Returned if the group does not exist. content: {} deprecated: true security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/by-id: get: tags: - Group summary: Atlassian Get Group description: 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). operationId: atlassianGetgroupbygroupid parameters: - name: id in: query description: The id of the group. required: true schema: type: string responses: '200': description: Returned if the requested group is returned. content: application/json: schema: $ref: '#/components/schemas/Group' '403': description: 'Returned if the calling user does not have permission to view groups.' content: {} '404': description: Returned if the group does not exist. content: {} security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK delete: tags: - Group summary: Atlassian Delete User Group description: Delete user group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianRemovegroupbyid parameters: - name: id in: query description: Id of the group to delete. required: true schema: type: string responses: '204': description: Returned if the group was removed successfully. content: {} '400': description: Returned if the id is missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: Returned if the user is not a site admin. content: {} '404': description: If no user group by the given id exists. content: {} security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: INACCESSIBLE x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/{groupName}: get: tags: - Group summary: Atlassian Get Group description: 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). operationId: atlassianGetgroupbyname parameters: - name: groupName in: path description: 'The name of the group. This is the same as the group name shown in the Confluence administration console.' required: true schema: type: string responses: '200': description: Returned if the requested group is returned. content: application/json: schema: $ref: '#/components/schemas/Group' '403': description: 'Returned if the calling user does not have permission to view groups.' content: {} '404': description: Returned if the group does not exist. content: {} deprecated: true x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/member: get: tags: - Group summary: Atlassian Get Group Members description: 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). operationId: atlassianGetmembersbyqueryparam parameters: - name: name in: query description: The name of the group to be queried for its members. required: true schema: type: string - name: start in: query description: The starting index of the returned users. schema: minimum: 0 type: integer format: int32 default: 0 - name: limit in: query description: '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.' schema: minimum: 0 type: integer format: int32 default: 200 - name: shouldReturnTotalSize in: query description: '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.' schema: type: boolean default: false - name: expand in: query description: "A multi-value parameter indicating which properties of the user to\nexpand.\n\n - `operations` returns the operations that the user is allowed to do.\n - `personalSpace` returns the user's personal space, if it exists.\n - `isExternalCollaborator` returns whether the user is an external collaborator user." style: form explode: false schema: type: array items: type: string enum: - operations - personalSpace - isExternalCollaborator responses: '200': description: Returned if the requested users are returned. content: application/json: schema: $ref: '#/components/schemas/UserArray' '403': description: Returned if the calling user does not have permission to view users. content: {} deprecated: true security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence - read:user:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/{groupName}/member: get: tags: - Group summary: Atlassian Get Group Members description: 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). operationId: atlassianGetgroupmembers parameters: - name: groupName in: path description: The name of the group to be queried for its members. required: true schema: type: string - name: start in: query description: The starting index of the returned users. schema: minimum: 0 type: integer format: int32 default: 0 - name: limit in: query description: 'The maximum number of users to return per page. Note, this may be restricted by fixed system limits.' schema: minimum: 0 type: integer format: int32 default: 200 responses: '200': description: Returned if the requested users are returned. content: application/json: schema: $ref: '#/components/schemas/UserArray' '400': description: Returned if given limit is greater than 200 content: {} '403': description: Returned if the calling user does not have permission to view users. content: {} deprecated: true x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/picker: get: tags: - Group summary: Atlassian Search Groups by Partial Query description: Get search results of groups by partial query provided. operationId: atlassianSearchgroups parameters: - name: query in: query description: the search term used to query results. required: true schema: type: string - name: start in: query description: The starting index of the returned groups. schema: minimum: 0 type: integer format: int32 default: 0 - name: limit in: query description: 'The maximum number of groups to return per page. Note, this is restricted to a maximum limit of 200 groups.' schema: minimum: 0 type: integer format: int32 default: 200 - name: shouldReturnTotalSize in: query description: '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.' schema: type: boolean default: false responses: '200': description: Returns a full JSON representation of group collection. content: application/json: schema: $ref: '#/components/schemas/GroupArrayWithLinks' '403': description: 'Returned if the calling user does not have permission to view groups.' content: {} security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/userByGroupId: post: tags: - Group summary: Atlassian Add Member to Group by Groupid description: 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. operationId: atlassianAddusertogroupbygroupid parameters: - name: groupId in: query description: GroupId of the group whose membership is updated required: true schema: type: string requestBody: description: AccountId of the user who needs to be added as member. content: application/json: schema: $ref: '#/components/schemas/AccountId' required: true responses: '201': description: Returned if the group was created successfully. content: {} '400': description: Returned if the groupId or accountId are missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: Returned if the user is not a site admin. content: {} '404': description: If no user group by the give name exists. content: {} security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-codegen-request-body-name: body x-atlassian-connect-scope: INACCESSIBLE x-microcks-operation: delay: 0 dispatcher: FALLBACK delete: tags: - Group summary: Atlassian Remove Member From Group Using Group Id description: Remove user as a member from a group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianRemovememberfromgroupbygroupid parameters: - name: groupId in: query description: Id of the group whose membership is updated. required: true schema: type: string - $ref: '#/components/parameters/userLookupKey' - $ref: '#/components/parameters/userLookupUsername' - $ref: '#/components/parameters/userLookupAccountId' responses: '204': description: Returned if the group was removed successfully. content: {} '400': description: Returned if the name is missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: 'Returned if the user is not a site admin. Note: A 204 is returned if the user is not part of the group.' content: {} '404': description: 'If no user group by the give name exists or if no user exists for the given accountId.' content: {} security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: INACCESSIBLE x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/{groupId}/membersByGroupId: get: tags: - Group summary: Atlassian Get Group Members description: 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). operationId: atlassianGetgroupmembersbygroupid parameters: - name: groupId in: path description: The id of the group to be queried for its members. required: true schema: type: string - name: start in: query description: The starting index of the returned users. schema: minimum: 0 type: integer format: int32 default: 0 - name: limit in: query description: 'The maximum number of users to return per page. Note, this may be restricted by fixed system limits.' schema: minimum: 0 type: integer format: int32 default: 200 - name: shouldReturnTotalSize in: query description: '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.' schema: type: boolean default: false - name: expand in: query description: "A multi-value parameter indicating which properties of the user to\nexpand.\n\n - `operations` returns the operations that the user is allowed to do.\n - `personalSpace` returns the user's personal space, if it exists.\n - `isExternalCollaborator` returns whether the user is an external collaborator user." style: form explode: false schema: type: array items: type: string enum: - operations - personalSpace - isExternalCollaborator responses: '200': description: Returned if the requested users are returned. content: application/json: schema: $ref: '#/components/schemas/UserArray' '400': description: Returned if given limit is greater than 200 content: {} '403': description: Returned if the calling user does not have permission to view users. content: {} security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence - read:user:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group/user: post: tags: - Group summary: Atlassian Add Member to Group description: Adds a user as a member in a group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianAddusertogroup parameters: - name: name in: query description: Name of the group whose membership is updated required: true schema: type: string requestBody: description: AccountId of the user who needs to be added as member. content: application/json: schema: $ref: '#/components/schemas/AccountId' required: true responses: '201': description: Returned if the group was created successfully. content: {} '400': description: Returned if the name or accountId are missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: Returned if the user is not a site admin. content: {} '404': description: If no user group by the give name exists. content: {} deprecated: true security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-codegen-request-body-name: body x-atlassian-connect-scope: INACCESSIBLE x-microcks-operation: delay: 0 dispatcher: FALLBACK delete: tags: - Group summary: Atlassian Remove Member From Group description: Remove user as a member from a group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianRemovememberfromgroup parameters: - name: name in: query description: Name of the group whose membership is updated. required: true schema: type: string - $ref: '#/components/parameters/userLookupKey' - $ref: '#/components/parameters/userLookupUsername' - $ref: '#/components/parameters/userLookupAccountId' responses: '204': description: Returned if the group was removed successfully. content: {} '400': description: Returned if the name is missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: 'Returned if the user is not a site admin. Note: A 204 is returned if the user is not part of the group.' content: {} '404': description: 'If no user group by the give name exists or if no user exists for the given accountId.' content: {} deprecated: true security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: INACCESSIBLE x-microcks-operation: delay: 0 dispatcher: FALLBACK /wiki/rest/api/group: get: tags: - Group summary: Atlassian Get Groups description: 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). operationId: atlassianGetgroups parameters: - name: start in: query description: The starting index of the returned groups. schema: minimum: 0 type: integer format: int32 default: 0 - name: limit in: query description: 'The maximum number of groups to return per page. Note, this may be restricted by fixed system limits.' schema: minimum: 0 type: integer format: int32 default: 200 - name: accessType in: query description: The group permission level for which to filter results. required: false schema: type: string default: null enum: - user - admin - site-admin responses: '200': description: Returned if the requested groups are returned. content: application/json: schema: $ref: '#/components/schemas/GroupArrayWithLinks_3' '403': description: 'Returned if the calling user does not have permission to view groups.' content: {} security: - basicAuth: [] - oAuthDefinitions: - read:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - read:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: READ post: tags: - Group summary: Atlassian Create New User Group description: Creates a new user group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianCreategroup requestBody: description: Name of the group that is to be created. content: application/json: schema: $ref: '#/components/schemas/GroupName' required: true responses: '201': description: Returned if the group was created successfully. content: application/json: schema: $ref: '#/components/schemas/Group_3' '400': description: Returned if the name is missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: Returned if the user is not a site admin. content: {} security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - read:group:confluence - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-codegen-request-body-name: body x-atlassian-connect-scope: INACCESSIBLE delete: tags: - Group summary: Atlassian Delete User Group description: Delete user group.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
User must be a site admin. operationId: atlassianRemovegroup parameters: - name: name in: query description: Name of the group to delete. required: true schema: type: string responses: '204': description: Returned if the group was removed successfully. content: {} '400': description: Returned if the name is missing or invalid. content: {} '401': description: Returned if the calling user is not logged in to Confluence. content: {} '403': description: Returned if the user is not a site admin. content: {} '404': description: If no user group by the give name exists. content: {} deprecated: true security: - basicAuth: [] - oAuthDefinitions: - write:confluence-groups x-atlassian-oauth2-scopes: - scheme: oAuthDefinitions state: Current scopes: - write:confluence-groups - scheme: oAuthDefinitions state: Beta scopes: - write:group:confluence x-atlassian-data-security-policy: - app-access-rule-exempt: true x-atlassian-connect-scope: INACCESSIBLE components: schemas: LabelArray: required: - results - size type: object properties: results: type: array items: $ref: '#/components/schemas/Label' start: type: integer format: int32 limit: type: integer format: int32 size: type: integer format: int32 _links: $ref: '#/components/schemas/GenericLinks' Space: required: - _expandable - _links - key - name - status - type nullable: true type: object properties: id: type: integer format: int64 key: type: string name: type: string icon: $ref: '#/components/schemas/Icon' description: type: object properties: plain: $ref: '#/components/schemas/SpaceDescription' view: $ref: '#/components/schemas/SpaceDescription' _expandable: type: object properties: view: type: string plain: type: string homepage: $ref: '#/components/schemas/Content' type: type: string metadata: type: object properties: labels: $ref: '#/components/schemas/LabelArray' _expandable: type: object operations: type: array items: $ref: '#/components/schemas/OperationCheckResult' permissions: type: array items: $ref: '#/components/schemas/SpacePermission' status: type: string settings: $ref: '#/components/schemas/SpaceSettings' theme: $ref: '#/components/schemas/Theme' lookAndFeel: $ref: '#/components/schemas/LookAndFeel' history: required: - createdDate type: object properties: createdDate: type: string format: date-time createdBy: $ref: '#/components/schemas/User' _expandable: type: object properties: settings: type: string metadata: type: string operations: type: string lookAndFeel: type: string permissions: type: string icon: type: string description: type: string theme: type: string history: type: string homepage: type: string identifiers: type: string _links: $ref: '#/components/schemas/GenericLinks' HorizontalHeaderLookAndFeel: required: - backgroundColor - primaryNavigation type: object properties: backgroundColor: type: string button: $ref: '#/components/schemas/ButtonLookAndFeel' primaryNavigation: $ref: '#/components/schemas/TopNavigationLookAndFeel' secondaryNavigation: $ref: '#/components/schemas/NavigationLookAndFeel' search: $ref: '#/components/schemas/SearchFieldLookAndFeel' GenericLinks: type: object additionalProperties: oneOf: - type: object additionalProperties: true - type: string ButtonLookAndFeel: required: - backgroundColor - color type: object nullable: true properties: backgroundColor: type: string color: type: string UsersUserKeys: required: - userAccountIds nullable: true type: object additionalProperties: true properties: users: type: array items: $ref: '#/components/schemas/User' userKeys: type: array items: type: string _links: $ref: '#/components/schemas/GenericLinks' ContainerLookAndFeel: required: - background - backgroundColor - backgroundImage - backgroundSize - borderRadius - padding type: object nullable: true properties: background: type: string backgroundAttachment: type: string nullable: true backgroundBlendMode: type: string nullable: true backgroundClip: type: string nullable: true backgroundColor: type: string nullable: true backgroundImage: type: string nullable: true backgroundOrigin: type: string nullable: true backgroundPosition: type: string nullable: true backgroundRepeat: type: string nullable: true backgroundSize: type: string nullable: true padding: type: string borderRadius: type: string ContentChildType: type: object properties: attachment: required: - _links - value type: object properties: value: type: boolean _links: $ref: '#/components/schemas/GenericLinks' comment: required: - _links - value type: object properties: value: type: boolean _links: $ref: '#/components/schemas/GenericLinks' page: required: - _links - value type: object properties: value: type: boolean _links: $ref: '#/components/schemas/GenericLinks' _expandable: type: object properties: all: type: string attachment: type: string comment: type: string page: type: string whiteboard: type: string additionalProperties: true description: 'Shows whether a piece of content has attachments, comments, or child pages/whiteboards. Note, this doesn''t actually contain the child objects.' GroupName: required: - name type: object properties: name: type: string SearchFieldLookAndFeel: required: - backgroundColor - color type: object nullable: true properties: backgroundColor: type: string color: type: string MenusLookAndFeel: required: - color - hoverOrFocus type: object properties: hoverOrFocus: required: - backgroundColor type: object properties: backgroundColor: type: string color: type: string ContentHistory: required: - latest type: object nullable: true properties: latest: type: boolean createdBy: $ref: '#/components/schemas/User' ownedBy: $ref: '#/components/schemas/User' lastOwnedBy: $ref: '#/components/schemas/User' createdDate: type: string format: date-time lastUpdated: $ref: '#/components/schemas/Version' previousVersion: $ref: '#/components/schemas/Version' contributors: type: object properties: publishers: $ref: '#/components/schemas/UsersUserKeys' nextVersion: $ref: '#/components/schemas/Version' _expandable: type: object properties: lastUpdated: type: string previousVersion: type: string contributors: type: string nextVersion: type: string ownedBy: type: string lastOwnedBy: type: string _links: $ref: '#/components/schemas/GenericLinks' EmbeddedContent: type: object additionalProperties: true properties: entityId: type: integer format: int64 entityType: type: string entity: $ref: '#/components/schemas/Embeddable' WebResourceDependencies: type: object properties: _expandable: type: object additionalProperties: true properties: uris: oneOf: - type: string - type: object additionalProperties: true keys: type: array items: type: string contexts: type: array items: type: string uris: type: object properties: all: oneOf: - type: array items: type: string - type: string css: oneOf: - type: array items: type: string - type: string js: oneOf: - type: array items: type: string - type: string _expandable: type: object additionalProperties: true properties: css: oneOf: - type: array items: type: string - type: string js: oneOf: - type: array items: type: string - type: string tags: type: object properties: all: type: string css: type: string data: type: string js: type: string _expandable: type: object additionalProperties: true superbatch: $ref: '#/components/schemas/SuperBatchWebResources' ScreenLookAndFeel: required: - background type: object properties: background: type: string backgroundAttachment: type: string nullable: true backgroundBlendMode: type: string nullable: true backgroundClip: type: string nullable: true backgroundColor: type: string nullable: true backgroundImage: type: string nullable: true backgroundOrigin: type: string nullable: true backgroundPosition: type: string nullable: true backgroundRepeat: type: string nullable: true backgroundSize: type: string nullable: true layer: type: object properties: width: type: string height: type: string nullable: true gutterTop: type: string nullable: true gutterRight: type: string nullable: true gutterBottom: type: string nullable: true gutterLeft: type: string nullable: true TopNavigationLookAndFeel: required: - highlightColor type: object properties: color: type: string nullable: true highlightColor: type: string hoverOrFocus: type: object properties: backgroundColor: type: string color: type: string HeaderLookAndFeel: required: - backgroundColor - button - primaryNavigation - search - secondaryNavigation type: object properties: backgroundColor: type: string button: $ref: '#/components/schemas/ButtonLookAndFeel' primaryNavigation: $ref: '#/components/schemas/NavigationLookAndFeel' secondaryNavigation: $ref: '#/components/schemas/NavigationLookAndFeel' search: $ref: '#/components/schemas/SearchFieldLookAndFeel' Group: required: - name - type - id type: object properties: type: type: string default: group enum: - group example: group name: type: string example: Example Title id: type: string example: abc123 _links: $ref: '#/components/schemas/GenericLinks' SuperBatchWebResources: type: object properties: uris: type: object properties: all: oneOf: - type: array items: type: string - type: string css: oneOf: - type: array items: type: string - type: string js: oneOf: - type: array items: type: string - type: string tags: type: object properties: all: type: string css: type: string data: type: string js: type: string metatags: type: string _expandable: type: object additionalProperties: true UserArray: required: - results type: object properties: results: type: array items: $ref: '#/components/schemas/User' example: [] start: type: integer format: int32 example: 10 limit: type: integer format: int32 example: 10 size: type: integer format: int32 example: 10 totalSize: type: integer format: int64 default: 0 description: 'This property will return total count of the objects before pagination is applied. This value is returned if `shouldReturnTotalSize` is set to `true`.' example: 10 _links: $ref: '#/components/schemas/GenericLinks' Icon: required: - height - isDefault - path - width type: object nullable: true properties: path: type: string width: type: integer format: int32 height: type: integer format: int32 isDefault: type: boolean description: This object represents an icon. If used as a profilePicture, this may be returned as null, depending on the user's privacy setting. GenericAccountId: type: string nullable: true description: 'The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, `384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192`.' Theme: required: - themeKey type: object properties: themeKey: type: string name: type: string description: type: string icon: $ref: '#/components/schemas/Icon' _links: $ref: '#/components/schemas/GenericLinks' Label: required: - id - label - name - prefix type: object properties: prefix: type: string name: type: string id: type: string label: type: string Group_3: required: - name - type - id type: object properties: type: type: string default: group enum: - group name: type: string id: type: string _links: $ref: '#/components/schemas/GenericLinks' SpaceDescription: required: - embeddedContent - representation - value type: object additionalProperties: true properties: value: type: string representation: type: string enum: - plain - view embeddedContent: type: array items: type: object properties: {} GenericUserKey: type: string nullable: true description: 'This property 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.' GroupArrayWithLinks_3: description: Same as GroupArray but with `_links` property. required: - limit - results - size - start - _links type: object properties: results: type: array items: $ref: '#/components/schemas/Group_3' start: type: integer format: int32 limit: type: integer format: int32 size: type: integer format: int32 totalSize: type: integer format: int64 default: 0 description: 'This property will return total count of the objects before pagination is applied. This value is returned if `shouldReturnTotalSize` is set to `true`.' _links: $ref: '#/components/schemas/GenericLinks' GroupArrayWithLinks: description: Same as GroupArray but with `_links` property. required: - limit - results - size - start - _links type: object properties: results: type: array items: $ref: '#/components/schemas/Group' example: [] start: type: integer format: int32 example: 10 limit: type: integer format: int32 example: 10 size: type: integer format: int32 example: 10 totalSize: type: integer format: int64 default: 0 description: 'This property will return total count of the objects before pagination is applied. This value is returned if `shouldReturnTotalSize` is set to `true`.' example: 10 _links: $ref: '#/components/schemas/GenericLinks' ContentChildren: type: object additionalProperties: true properties: attachment: $ref: '#/components/schemas/ContentArray' comment: $ref: '#/components/schemas/ContentArray' page: $ref: '#/components/schemas/ContentArray' _expandable: type: object additionalProperties: true properties: attachment: type: string comment: type: string page: type: string _links: $ref: '#/components/schemas/GenericLinks' ContentMetadata: type: object additionalProperties: true properties: currentuser: type: object properties: favourited: type: object properties: isFavourite: type: boolean favouritedDate: type: string format: date-time lastmodified: type: object properties: version: $ref: '#/components/schemas/Version' friendlyLastModified: type: string lastcontributed: type: object properties: status: type: string when: type: string format: date-time viewed: type: object properties: lastSeen: type: string format: date-time friendlyLastSeen: type: string scheduled: type: object _expandable: type: object properties: favourited: type: string lastmodified: type: string lastcontributed: type: string viewed: type: string scheduled: type: string properties: $ref: '#/components/schemas/GenericLinks' frontend: type: object additionalProperties: true labels: oneOf: - $ref: '#/components/schemas/LabelArray' - type: array items: $ref: '#/components/schemas/Label' description: Metadata object for page, blogpost, comment content ContentBody: required: - representation - value type: object properties: value: type: string representation: type: string enum: - view - export_view - styled_view - storage - editor - editor2 - anonymous_export_view - wiki - atlas_doc_format - raw embeddedContent: type: array items: $ref: '#/components/schemas/EmbeddedContent' webresource: $ref: '#/components/schemas/WebResourceDependencies' mediaToken: type: object properties: collectionIds: type: array items: type: string contentId: type: string expiryDateTime: type: string fileIds: type: array items: type: string token: type: string _expandable: type: object properties: content: type: string embeddedContent: type: string webresource: type: string mediaToken: type: string _links: $ref: '#/components/schemas/GenericLinks' LookAndFeel: required: - bordersAndDividers - content - header - headings - links - menus type: object properties: headings: required: - color type: object properties: color: type: string links: required: - color type: object properties: color: type: string menus: $ref: '#/components/schemas/MenusLookAndFeel' header: $ref: '#/components/schemas/HeaderLookAndFeel' horizontalHeader: $ref: '#/components/schemas/HorizontalHeaderLookAndFeel' content: $ref: '#/components/schemas/ContentLookAndFeel' bordersAndDividers: required: - color type: object properties: color: type: string spaceReference: type: object nullable: true Container: type: object nullable: true additionalProperties: true description: 'Container for content. This can be either a space (containing a page or blogpost) or a page/blog post (containing an attachment or comment)' OperationCheckResult: required: - operation - targetType type: object properties: operation: type: string description: The operation itself. enum: - administer - archive - clear_permissions - copy - create - create_space - delete - export - move - purge - purge_version - read - restore - restrict_content - update - use targetType: type: string description: The space or content type that the operation applies to. Could be one of- - application - page - blogpost - comment - attachment - space description: An operation and the target entity that it applies to, e.g. create page. User: required: - type type: object additionalProperties: true nullable: true properties: type: type: string enum: - known - unknown - anonymous - user username: $ref: '#/components/schemas/GenericUserName' userKey: $ref: '#/components/schemas/GenericUserKey' accountId: $ref: '#/components/schemas/GenericAccountId' accountType: type: string description: The account type of the user, may return empty string if unavailable. App is if the user is a bot user created on behalf of an Atlassian app. enum: - atlassian - app - '' email: nullable: true type: string description: The email address of the user. Depending on the user's privacy setting, this may return an empty string. publicName: type: string description: The public name or nickname of the user. Will always contain a value. profilePicture: $ref: '#/components/schemas/Icon' displayName: nullable: true type: string description: The displays name of the user. Depending on the user's privacy setting, this may be the same as publicName. timeZone: nullable: true type: string description: This displays user time zone. Depending on the user's privacy setting, this may return null. isExternalCollaborator: type: boolean description: Whether the user is an external collaborator user externalCollaborator: type: boolean description: Whether the user is an external collaborator user operations: nullable: true type: array items: $ref: '#/components/schemas/OperationCheckResult' details: $ref: '#/components/schemas/UserDetails' personalSpace: $ref: '#/components/schemas/Space' _expandable: type: object properties: operations: type: string details: type: string personalSpace: type: string _links: $ref: '#/components/schemas/GenericLinks' SpacePermission: required: - anonymousAccess - operation - unlicensedAccess type: object properties: id: type: integer format: int64 subjects: type: object properties: user: required: - results - size type: object properties: results: type: array items: $ref: '#/components/schemas/User' size: type: integer format: int32 start: type: integer format: int32 limit: type: integer format: int32 group: required: - results - size type: object properties: results: type: array items: $ref: '#/components/schemas/Group_3' size: type: integer format: int32 start: type: integer format: int32 limit: type: integer format: int32 _expandable: type: object properties: user: type: string group: type: string description: The users and/or groups that the permission applies to. operation: $ref: '#/components/schemas/OperationCheckResult' anonymousAccess: type: boolean description: Grant anonymous users permission to use the operation. default: false unlicensedAccess: type: boolean description: 'Grants access to unlicensed users from JIRA Service Desk when used with the ''read space'' operation.' default: false description: "This object represents a permission for given space. Permissions consist of\nat least one operation object with an accompanying subjects object.\n\nThe following combinations of `operation` and `targetType` values are\nvalid for the `operation` object:\n\n - 'create': 'page', 'blogpost', 'comment', 'attachment'\n - 'read': 'space'\n - 'delete': 'page', 'blogpost', 'comment', 'attachment'\n - 'export': 'space'\n - 'administer': 'space'" ContentLookAndFeel: type: object properties: screen: $ref: '#/components/schemas/ScreenLookAndFeel' container: $ref: '#/components/schemas/ContainerLookAndFeel' header: $ref: '#/components/schemas/ContainerLookAndFeel' body: $ref: '#/components/schemas/ContainerLookAndFeel' ContentArray: required: - _links - results - size type: object properties: results: type: array items: $ref: '#/components/schemas/Content' start: type: integer format: int32 limit: type: integer format: int32 size: type: integer format: int32 _links: $ref: '#/components/schemas/GenericLinks' NavigationLookAndFeel: required: - color - hoverOrFocus type: object nullable: true properties: color: type: string highlightColor: type: string nullable: true hoverOrFocus: required: - backgroundColor - color type: object properties: backgroundColor: type: string color: type: string GroupArray: required: - limit - results - size - start type: object properties: results: type: array items: $ref: '#/components/schemas/Group_3' start: type: integer format: int32 limit: type: integer format: int32 size: type: integer format: int32 ContentRestriction: required: - _expandable - _links - operation type: object properties: operation: type: string enum: - administer - copy - create - delete - export - move - purge - purge_version - read - restore - update - use restrictions: type: object properties: user: $ref: '#/components/schemas/UserArray_3' group: $ref: '#/components/schemas/GroupArray' _expandable: type: object properties: user: type: string group: type: string content: $ref: '#/components/schemas/Content' _expandable: type: object properties: restrictions: type: string content: type: string _links: $ref: '#/components/schemas/GenericLinks' Content: required: - status - type nullable: true type: object additionalProperties: true properties: id: type: string type: type: string description: Can be "page", "blogpost", "attachment" or "content" status: type: string title: type: string space: $ref: '#/components/schemas/Space' history: $ref: '#/components/schemas/ContentHistory' version: $ref: '#/components/schemas/Version' ancestors: nullable: true type: array items: $ref: '#/components/schemas/Content' operations: type: array items: $ref: '#/components/schemas/OperationCheckResult' children: $ref: '#/components/schemas/ContentChildren' childTypes: $ref: '#/components/schemas/ContentChildType' descendants: $ref: '#/components/schemas/ContentChildren' container: $ref: '#/components/schemas/Container' body: type: object properties: view: $ref: '#/components/schemas/ContentBody' export_view: $ref: '#/components/schemas/ContentBody' styled_view: $ref: '#/components/schemas/ContentBody' storage: $ref: '#/components/schemas/ContentBody' wiki: $ref: '#/components/schemas/ContentBody' editor: $ref: '#/components/schemas/ContentBody' editor2: $ref: '#/components/schemas/ContentBody' anonymous_export_view: $ref: '#/components/schemas/ContentBody' atlas_doc_format: $ref: '#/components/schemas/ContentBody' dynamic: $ref: '#/components/schemas/ContentBody' raw: $ref: '#/components/schemas/ContentBody' _expandable: type: object properties: editor: type: string view: type: string export_view: type: string styled_view: type: string storage: type: string editor2: type: string anonymous_export_view: type: string atlas_doc_format: type: string wiki: type: string dynamic: type: string raw: type: string restrictions: type: object properties: read: $ref: '#/components/schemas/ContentRestriction' update: $ref: '#/components/schemas/ContentRestriction' _expandable: type: object properties: read: type: string update: type: string _links: $ref: '#/components/schemas/GenericLinks' metadata: $ref: '#/components/schemas/ContentMetadata' macroRenderedOutput: type: object additionalProperties: type: object extensions: type: object _expandable: type: object properties: childTypes: type: string container: type: string metadata: type: string operations: type: string children: type: string restrictions: type: string history: type: string ancestors: type: string body: type: string version: type: string descendants: type: string space: type: string extensions: type: string schedulePublishDate: type: string schedulePublishInfo: type: string macroRenderedOutput: type: string _links: $ref: '#/components/schemas/GenericLinks' description: Base object for all content types. Version: required: - minorEdit - number - when type: object nullable: true additionalProperties: true properties: by: $ref: '#/components/schemas/User' when: type: string format: date-time nullable: true friendlyWhen: type: string nullable: true message: type: string nullable: true number: type: integer format: int32 description: Set this to the current version number incremented by one minorEdit: description: 'If `minorEdit` is set to ''true'', no notification email or activity stream will be generated for the change.' type: boolean content: $ref: '#/components/schemas/Content' collaborators: $ref: '#/components/schemas/UsersUserKeys' _expandable: type: object properties: content: type: string collaborators: type: string _links: $ref: '#/components/schemas/GenericLinks' contentTypeModified: type: boolean description: True if content type is modifed in this version (e.g. page to blog) confRev: type: string nullable: true description: The revision id provided by confluence to be used as a revision in Synchrony syncRev: type: string nullable: true description: The revision id provided by Synchrony syncRevSource: type: string nullable: true description: Source of the synchrony revision AccountId: required: - accountId type: object properties: accountId: type: string GenericUserName: type: string nullable: true description: 'This property 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.' Embeddable: type: object additionalProperties: true UserArray_3: required: - results type: object properties: results: type: array items: $ref: '#/components/schemas/User' start: type: integer format: int32 limit: type: integer format: int32 size: type: integer format: int32 totalSize: type: integer format: int64 default: 0 description: 'This property will return total count of the objects before pagination is applied. This value is returned if `shouldReturnTotalSize` is set to `true`.' _links: $ref: '#/components/schemas/GenericLinks' SpaceSettings: nullable: true required: - _links - routeOverrideEnabled type: object properties: routeOverrideEnabled: type: boolean description: 'Defines whether an override for the space home should be used. This is used in conjunction with a space theme provided by an app. For example, if this property is set to true, a theme can display a page other than the space homepage when users visit the root URL for a space. This property allows apps to provide content-only theming without overriding the space home.' editor: required: - page - blogpost - default type: object properties: page: type: string blogpost: type: string default: type: string spaceKey: type: string _links: $ref: '#/components/schemas/GenericLinks' UserDetails: type: object properties: business: type: object properties: position: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' department: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' location: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' personal: type: object properties: phone: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' im: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' website: type: string description: 'This property has been deprecated due to privacy changes. There is no replacement. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' email: type: string description: 'This property has been deprecated due to privacy changes. Use the `User.email` property instead. See the [migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.' parameters: userLookupAccountId: name: accountId in: query description: 'The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, `384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192`.' schema: type: string userLookupUsername: name: username in: query deprecated: true description: '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.' schema: type: string userLookupKey: name: key in: query deprecated: true description: '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.' schema: type: string securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: Use an Atlassian API key as a Bearer token. Create API keys at https://admin.atlassian.com. oauth2: type: oauth2 description: OAuth 2.0 authorization for Atlassian Cloud APIs. flows: authorizationCode: authorizationUrl: https://auth.atlassian.com/authorize tokenUrl: https://auth.atlassian.com/oauth/token scopes: read:org:admin: Read organization information. write:org:admin: Modify organization settings. read:user:admin: Read user information. write:user:admin: Modify user accounts. read:policy:admin: Read organization policies. write:policy:admin: Modify organization policies. read:event:admin: Read organization events. externalDocs: description: Atlassian Admin REST API Documentation url: https://developer.atlassian.com/cloud/admin/organization/rest/intro/