openapi: 3.1.0
info:
title: Atlassian Admin Account Relation 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: Relation
paths:
/wiki/rest/api/relation/{relationName}/from/{sourceType}/{sourceKey}/to/{targetType}:
get:
tags:
- Relation
summary: Atlassian Find Target Entities Related to a Source Entity
description: Returns all target entities that have a particular relationship to the
source entity. Note, relationships are one way.
For example, the following method finds all content that the current user
has an 'ignore' relationship with:
`GET /wiki/rest/api/relation/ignore/from/user/current/to/content`
Note, 'ignore' is an example custom relationship type.
**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to view both the target entity and source entity.
operationId: atlassianFindtargetfromsource
parameters:
- name: relationName
in: path
description: 'The name of the relationship. This method supports relationships created via
[Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put).
Note, this method does not support ''like'' or ''favourite'' relationships.'
required: true
schema:
type: string
- name: sourceType
in: path
description: The source entity type of the relationship.
required: true
schema:
type: string
enum:
- user
- content
- space
- name: sourceKey
in: path
description: 'The identifier for the source entity:
- If `sourceType` is `user`, then specify either `current` (logged-in user), the user key of the user, or
the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the
[migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/)
for details.
- If `sourceType` is ''content'', then specify the content ID.
- If `sourceType` is ''space'', then specify the space key.'
required: true
schema:
type: string
- name: targetType
in: path
description: The target entity type of the relationship.
required: true
schema:
type: string
enum:
- user
- content
- space
- name: sourceStatus
in: query
description: 'The status of the source. This parameter is only used when the
`sourceType` is ''content''.'
schema:
type: string
- name: targetStatus
in: query
description: 'The status of the target. This parameter is only used when the
`targetType` is ''content''.'
schema:
type: string
- name: sourceVersion
in: query
description: 'The version of the source. This parameter is only used when the
`sourceType` is ''content'' and the `sourceStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: targetVersion
in: query
description: 'The version of the target. This parameter is only used when the
`targetType` is ''content'' and the `targetStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: expand
in: query
description: 'A multi-value parameter indicating which properties of the response
object to expand.
- `relationData` returns information about the relationship, such as
who created it and when it was created.
- `source` returns the source entity.
- `target` returns the target entity.'
style: form
explode: false
schema:
type: array
items:
type: string
enum:
- relationData
- source
- target
- name: start
in: query
description: The starting index of the returned relationships.
schema:
minimum: 0
type: integer
format: int32
default: 0
- name: limit
in: query
description: 'The maximum number of relationships to return per page.
Note, this may be restricted by fixed system limits.'
schema:
minimum: 0
type: integer
format: int32
default: 25
responses:
'200':
description: Returned if the requested relationships are returned.
content:
application/json:
schema:
$ref: '#/components/schemas/RelationArray'
'400':
description: Returned if the request is invalid.
content: {}
'403':
description: 'Returned if the user does not have permission to view the
relationships.'
content: {}
'404':
description: Returned if the target entity does not exist.
content: {}
security:
- basicAuth: []
- oAuthDefinitions:
- read:confluence-content.summary
x-atlassian-oauth2-scopes:
- scheme: oAuthDefinitions
state: Current
scopes:
- read:confluence-content.summary
- scheme: oAuthDefinitions
state: Beta
scopes:
- read:relation:confluence
- read:content-details:confluence
x-atlassian-data-security-policy:
- app-access-rule-exempt: false
x-atlassian-connect-scope: READ
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/wiki/rest/api/relation/{relationName}/from/{sourceType}/{sourceKey}/to/{targetType}/{targetKey}:
get:
tags:
- Relation
summary: Atlassian Find Relationship From Source to Target
description: Find whether a particular type of relationship exists from a source
entity to a target entity. Note, relationships are one way.
For example, you can use this method to find whether the current user has
selected a particular page as a favorite (i.e. 'save for later'):
`GET /wiki/rest/api/relation/favourite/from/user/current/to/content/123`
**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to view both the target entity and source entity.
operationId: atlassianGetrelationship
parameters:
- name: relationName
in: path
description: 'The name of the relationship. This method supports the ''favourite''
(i.e. ''save for later'') relationship as well as any other relationship
types created via [Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put).'
required: true
schema:
type: string
- name: sourceType
in: path
description: 'The source entity type of the relationship. This must be ''user'', if
the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: sourceKey
in: path
description: '- The identifier for the source entity:
- If `sourceType` is `user`, then specify either `current` (logged-in user), the user key of the user, or
the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the
[migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/)
for details.
- If `sourceType` is ''content'', then specify the content ID.
- If `sourceType` is ''space'', then specify the space key.'
required: true
schema:
type: string
- name: targetType
in: path
description: 'The target entity type of the relationship. This must be ''space'' or
''content'', if the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: targetKey
in: path
description: 'The identifier for the target entity:
- If `targetType` is `user`, then specify either `current` (logged-in user), the user key of the user, or
the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the
[migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/)
for details.
- If `targetType` is ''content'', then specify the content ID.
- If `targetType` is ''space'', then specify the space key.'
required: true
schema:
type: string
- name: sourceStatus
in: query
description: 'The status of the source. This parameter is only used when the
`sourceType` is ''content''.'
schema:
type: string
- name: targetStatus
in: query
description: 'The status of the target. This parameter is only used when the
`targetType` is ''content''.'
schema:
type: string
- name: sourceVersion
in: query
description: 'The version of the source. This parameter is only used when the
`sourceType` is ''content'' and the `sourceStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: targetVersion
in: query
description: 'The version of the target. This parameter is only used when the
`targetType` is ''content'' and the `targetStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: expand
in: query
description: 'A multi-value parameter indicating which properties of the response
object to expand.
- `relationData` returns information about the relationship, such as
who created it and when it was created.
- `source` returns the source entity.
- `target` returns the target entity.'
style: form
explode: false
schema:
type: array
items:
type: string
enum:
- relationData
- source
- target
responses:
'200':
description: Returned if the relationship exists.
content:
application/json:
schema:
$ref: '#/components/schemas/Relation'
'400':
description: Returned if the request is invalid.
content: {}
'401':
description: 'Returned if the authentication credentials are incorrect or missing
from the request.'
content: {}
'403':
description: 'Returned if the user does not have permission to view the
relationship.'
content: {}
'404':
description: Returned if the relationship does not exist.
content: {}
security:
- basicAuth: []
- oAuthDefinitions:
- read:confluence-content.summary
x-atlassian-oauth2-scopes:
- scheme: oAuthDefinitions
state: Current
scopes:
- read:confluence-content.summary
- scheme: oAuthDefinitions
state: Beta
scopes:
- read:relation:confluence
- read:content-details:confluence
x-atlassian-data-security-policy:
- app-access-rule-exempt: false
x-atlassian-connect-scope: READ
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
put:
tags:
- Relation
summary: Atlassian Create Relationship
description: Creates a relationship between two entities (user, space, content). The
'favourite' relationship is supported by default, but you can use this method
to create any type of relationship between two entities.
For example, the following method creates a 'sibling' relationship between
two pieces of content:
`GET /wiki/rest/api/relation/sibling/from/content/123/to/content/456`
**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site ('Can use' global permission).
operationId: atlassianCreaterelationship
parameters:
- name: relationName
in: path
description: 'The name of the relationship. This method supports the ''favourite''
(i.e. ''save for later'') relationship. You can also specify any other
value for this parameter to create a custom relationship type.'
required: true
schema:
type: string
- name: sourceType
in: path
description: 'The source entity type of the relationship. This must be ''user'', if
the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: sourceKey
in: path
description: "- The identifier for the source entity:\n\n- If `sourceType` is 'user', then specify either 'current' (logged-in\n user) or the user key.\n- If `sourceType` is 'content', then specify the content ID.\n- If `sourceType` is 'space', then specify the space key."
required: true
schema:
type: string
- name: targetType
in: path
description: 'The target entity type of the relationship. This must be ''space'' or
''content'', if the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: targetKey
in: path
description: "- The identifier for the target entity:\n\n- If `sourceType` is 'user', then specify either 'current' (logged-in\n user) or the user key.\n- If `sourceType` is 'content', then specify the content ID.\n- If `sourceType` is 'space', then specify the space key."
required: true
schema:
type: string
- name: sourceStatus
in: query
description: 'The status of the source. This parameter is only used when the
`sourceType` is ''content''.'
schema:
type: string
- name: targetStatus
in: query
description: 'The status of the target. This parameter is only used when the
`targetType` is ''content''.'
schema:
type: string
- name: sourceVersion
in: query
description: 'The version of the source. This parameter is only used when the
`sourceType` is ''content'' and the `sourceStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: targetVersion
in: query
description: 'The version of the target. This parameter is only used when the
`targetType` is ''content'' and the `targetStatus` is ''historical''.'
schema:
type: integer
format: int32
responses:
'200':
description: Returned if the relationship is created.
content:
application/json:
schema:
$ref: '#/components/schemas/Relation'
'400':
description: Returned if the request is invalid.
content: {}
'401':
description: 'Returned if the authentication credentials are incorrect or missing
from the request.'
content: {}
'403':
description: Returned if the user does not have permission to use Confluence.
content: {}
'404':
description: Returned if the user, space or content could not be found.
content: {}
security:
- basicAuth: []
- oAuthDefinitions:
- write:confluence-content
x-atlassian-oauth2-scopes:
- scheme: oAuthDefinitions
state: Current
scopes:
- write:confluence-content
- scheme: oAuthDefinitions
state: Beta
scopes:
- read:relation:confluence
- read:space:confluence
- read:user:confluence
- read:content:confluence
- write:relation:confluence
x-atlassian-data-security-policy:
- app-access-rule-exempt: false
x-atlassian-connect-scope: WRITE
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
delete:
tags:
- Relation
summary: Atlassian Delete Relationship
description: Deletes a relationship between two entities (user, space, content).
**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site ('Can use' global permission).
For favourite relationships, the current user can only delete their own
favourite relationships. A space administrator can delete favourite
relationships for any user.
operationId: atlassianDeleterelationship
parameters:
- name: relationName
in: path
description: The name of the relationship.
required: true
schema:
type: string
- name: sourceType
in: path
description: 'The source entity type of the relationship. This must be ''user'', if
the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: sourceKey
in: path
description: "- The identifier for the source entity:\n\n- If `sourceType` is 'user', then specify either 'current' (logged-in\n user) or the user key.\n- If `sourceType` is 'content', then specify the content ID.\n- If `sourceType` is 'space', then specify the space key."
required: true
schema:
type: string
- name: targetType
in: path
description: 'The target entity type of the relationship. This must be ''space'' or
''content'', if the `relationName` is ''favourite''.'
required: true
schema:
type: string
enum:
- user
- content
- space
- name: targetKey
in: path
description: "- The identifier for the target entity:\n\n- If `sourceType` is 'user', then specify either 'current' (logged-in\n user) or the user key.\n- If `sourceType` is 'content', then specify the content ID.\n- If `sourceType` is 'space', then specify the space key."
required: true
schema:
type: string
- name: sourceStatus
in: query
description: 'The status of the source. This parameter is only used when the
`sourceType` is ''content''.'
schema:
type: string
- name: targetStatus
in: query
description: 'The status of the target. This parameter is only used when the
`targetType` is ''content''.'
schema:
type: string
- name: sourceVersion
in: query
description: 'The version of the source. This parameter is only used when the
`sourceType` is ''content'' and the `sourceStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: targetVersion
in: query
description: 'The version of the target. This parameter is only used when the
`targetType` is ''content'' and the `targetStatus` is ''historical''.'
schema:
type: integer
format: int32
responses:
'204':
description: 'Returned if the relationship is deleted or the relationship didn''t
exist.'
content: {}
'400':
description: Returned if the request is invalid.
content: {}
'401':
description: 'Returned if the authentication credentials are incorrect or missing
from the request.'
content: {}
'403':
description: 'Returned if the user does not have permission to delete the
relationship.'
content: {}
'404':
description: Returned if the user, space or content could not be found.
content: {}
security:
- basicAuth: []
- oAuthDefinitions:
- write:confluence-content
x-atlassian-oauth2-scopes:
- scheme: oAuthDefinitions
state: Current
scopes:
- write:confluence-content
- scheme: oAuthDefinitions
state: Beta
scopes:
- write:relation:confluence
x-atlassian-data-security-policy:
- app-access-rule-exempt: false
x-atlassian-connect-scope: WRITE
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/wiki/rest/api/relation/{relationName}/to/{targetType}/{targetKey}/from/{sourceType}:
get:
tags:
- Relation
summary: Atlassian Find Source Entities Related to a Target Entity
description: Returns all target entities that have a particular relationship to the
source entity. Note, relationships are one way.
For example, the following method finds all users that have a 'collaborator'
relationship to a piece of content with an ID of '1234':
`GET /wiki/rest/api/relation/collaborator/to/content/1234/from/user`
Note, 'collaborator' is an example custom relationship type.
**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to view both the target entity and source entity.
operationId: atlassianFindsourcesfortarget
parameters:
- name: relationName
in: path
description: 'The name of the relationship. This method supports relationships created via
[Create relationship](#api-wiki-rest-api-relation-relationname-from-sourcetype-sourcekey-to-targettype-targetkey-put).
Note, this method does not support ''like'' or ''favourite'' relationships.'
required: true
schema:
type: string
- name: sourceType
in: path
description: The source entity type of the relationship.
required: true
schema:
type: string
enum:
- user
- content
- space
- name: targetType
in: path
description: The target entity type of the relationship.
required: true
schema:
type: string
enum:
- user
- content
- space
- name: targetKey
in: path
description: 'The identifier for the target entity:
- If `targetType` is `user`, then specify either `current` (logged-in user), the user key of the user, or
the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the
[migration guide](https://developer.atlassian.com/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/)
for details.
- If `targetType` is ''content'', then specify the content ID.
- If `targetType` is ''space'', then specify the space key.'
required: true
schema:
type: string
- name: sourceStatus
in: query
description: 'The status of the source. This parameter is only used when the
`sourceType` is ''content''.'
schema:
type: string
- name: targetStatus
in: query
description: 'The status of the target. This parameter is only used when the
`targetType` is ''content''.'
schema:
type: string
- name: sourceVersion
in: query
description: 'The version of the source. This parameter is only used when the
`sourceType` is ''content'' and the `sourceStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: targetVersion
in: query
description: 'The version of the target. This parameter is only used when the
`targetType` is ''content'' and the `targetStatus` is ''historical''.'
schema:
type: integer
format: int32
- name: expand
in: query
description: 'A multi-value parameter indicating which properties of the response
object to expand.
- `relationData` returns information about the relationship, such as
who created it and when it was created.
- `source` returns the source entity.
- `target` returns the target entity.'
style: form
explode: false
schema:
type: array
items:
type: string
enum:
- relationData
- source
- target
- name: start
in: query
description: The starting index of the returned relationships.
schema:
minimum: 0
type: integer
format: int32
default: 0
- name: limit
in: query
description: 'The maximum number of relationships to return per page.
Note, this may be restricted by fixed system limits.'
schema:
minimum: 0
type: integer
format: int32
default: 25
responses:
'200':
description: Returned if the requested relationships are returned.
content:
application/json:
schema:
$ref: '#/components/schemas/RelationArray'
'400':
description: Returned if the request is invalid.
content: {}
'403':
description: 'Returned if the user does not have permission to view the
relationship'
content: {}
'404':
description: Returned if the target entity does not exist.
content: {}
security:
- basicAuth: []
- oAuthDefinitions:
- read:confluence-content.summary
x-atlassian-oauth2-scopes:
- scheme: oAuthDefinitions
state: Current
scopes:
- read:confluence-content.summary
- scheme: oAuthDefinitions
state: Beta
scopes:
- read:relation:confluence
- read:content-details:confluence
x-atlassian-data-security-policy:
- app-access-rule-exempt: false
x-atlassian-connect-scope: READ
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
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
RelationData:
type: object
properties:
createdBy:
$ref: '#/components/schemas/User'
createdDate:
type: string
format: date-time
friendlyCreatedDate:
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.'
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
Relation:
required:
- _links
- name
type: object
properties:
name:
type: string
example: Example Title
relationData:
$ref: '#/components/schemas/RelationData'
source:
oneOf:
- $ref: '#/components/schemas/Content'
- $ref: '#/components/schemas/User'
- $ref: '#/components/schemas/Space'
example: example_value
target:
oneOf:
- $ref: '#/components/schemas/Content'
- $ref: '#/components/schemas/User'
- $ref: '#/components/schemas/Space'
example: example_value
_expandable:
type: object
properties:
relationData:
type: string
source:
type: string
target:
type: string
example: example_value
_links:
$ref: '#/components/schemas/GenericLinks'
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
name:
type: string
id:
type: string
_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'
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'
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
RelationArray:
required:
- _links
- limit
- results
- size
- start
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/Relation'
example: []
start:
type: integer
format: int32
example: 10
limit:
type: integer
format: int32
example: 10
size:
type: integer
format: int32
example: 10
_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.'
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'
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'
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'
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
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
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.'
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/