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/