Skip to content

Atlassian: Permissions schemas

9 Atlassian schemas with complete fields and constraints.

← Permissions operations · All schemas

Get bulk permissions — request body — body

FieldTypePresenceDescription and constraints
$objectRootDetails of global permissions to look up and project permissions with associated projects and issues to look up.
Additional keys: not allowed
accountIdstringOptionalThe account ID of a user.
globalPermissionsarrayOptionalGlobal permissions to look up.
Unique items: true
globalPermissions[]stringEach item
projectPermissionsarrayOptionalProject permissions with associated projects and issues to look up.
Unique items: true
projectPermissions[]ModelEach itemExpand Get bulk permissions — request body — body project Permissions item

Referenced models: Get bulk permissions — request body — body project Permissions item

Get bulk permissions — request body — body project Permissions item

FieldTypePresenceDescription and constraints
$objectRootDetails of project permissions and associated issues and projects to look up.
Additional keys: not allowed
issuesarrayOptionalList of issue IDs.
Unique items: true
issues[]integerEach itemFormat: int64
permissionsarrayRequired within parentList of project permissions.
Unique items: true
permissions[]stringEach item
projectsarrayOptionalList of project IDs.
Unique items: true
projects[]integerEach itemFormat: int64

Get bulk permissions — response body

FieldTypePresenceDescription and constraints
$objectRootDetails of global and project permissions granted to the user.
globalPermissionsJSONOptional
globalPermissions (anyOf 1)arrayAlternativeList of permissions granted to the user.
Unique items: true
globalPermissions (anyOf 1)[]stringEach item
globalPermissions (anyOf 2)nullAlternative
projectPermissionsJSONOptional
projectPermissions (anyOf 1)arrayAlternativeList of project permissions and the projects and issues those permissions provide access to.
Unique items: true
projectPermissions (anyOf 1)[]ModelEach itemExpand Get bulk permissions — response body — project Permissions array item
projectPermissions (anyOf 2)nullAlternative

Referenced models: Get bulk permissions — response body — project Permissions array item

Get bulk permissions — response body — project Permissions array item

FieldTypePresenceDescription and constraints
$objectRootList of project permissions and the projects and issues those permissions grant access to.
issuesJSONOptional
issues (anyOf 1)arrayAlternativeIDs of the issues the user has the permission for.
Unique items: true
issues (anyOf 1)[]JSONEach item
issues (anyOf 1)[] (anyOf 1)integerAlternativeFormat: int64
issues (anyOf 1)[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
issues (anyOf 2)nullAlternative
permissionJSONOptional
permission (anyOf 1)stringAlternativeA project permission,
permission (anyOf 2)nullAlternative
projectsJSONOptional
projects (anyOf 1)arrayAlternativeIDs of the projects the user has the permission for.
Unique items: true
projects (anyOf 1)[]JSONEach item
projects (anyOf 1)[] (anyOf 1)integerAlternativeFormat: int64
projects (anyOf 1)[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
projects (anyOf 2)nullAlternative

Get my permissions — response body

FieldTypePresenceDescription and constraints
$objectRootDetails about permissions.
permissionsJSONOptional
permissions (anyOf 1)objectAlternativeList of permissions.
Read only: true
Additional keys: see wildcard field
permissions (anyOf 1).*ModelAdditional keysExpand Get my permissions — response body — permissions List of permissions value
permissions (anyOf 2)nullAlternative

Referenced models: Get my permissions — response body — permissions List of permissions value

Get my permissions — response body — permissions List of permissions value

FieldTypePresenceDescription and constraints
$objectRootDetails of a permission and its availability to a user.
Additional keys: allowed
deprecatedKeyJSONOptional
deprecatedKey (anyOf 1)booleanAlternativeIndicate whether the permission key is deprecated. Note that deprecated keys cannot be used in the `permissions parameter of Get my permissions. Deprecated keys are not returned by Get all permissions.`
deprecatedKey (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternativeThe description of the permission.
description (anyOf 2)nullAlternative
havePermissionJSONOptional
havePermission (anyOf 1)booleanAlternativeWhether the permission is available to the user in the queried context.
havePermission (anyOf 2)nullAlternative
idJSONOptional
id (anyOf 1)stringAlternativeThe ID of the permission. Either `id` or `key` must be specified. Use [Get all permissions](#api-rest-api-3-permissions-get) to get the list of permissions.
id (anyOf 2)nullAlternative
keyJSONOptional
key (anyOf 1)stringAlternativeThe key of the permission. Either `id` or `key` must be specified. Use [Get all permissions](#api-rest-api-3-permissions-get) to get the list of permissions.
key (anyOf 2)nullAlternative
nameJSONOptional
name (anyOf 1)stringAlternativeThe name of the permission.
name (anyOf 2)nullAlternative
typeJSONOptional
type (anyOf 1)stringAlternativeThe type of the permission.
Known values: GLOBAL, PROJECT
type (anyOf 2)nullAlternative

Get permitted projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
permissionsarrayRequired within parentA list of permission keys.
permissions[]stringEach item

Get permitted projects — response body

FieldTypePresenceDescription and constraints
$objectRootA list of projects in which a user is granted permissions.
projectsJSONOptional
projects (anyOf 1)arrayAlternativeA list of projects.
Read only: true
projects (anyOf 1)[]ModelEach itemExpand Get permitted projects — response body — projects A list of projects item
projects (anyOf 2)nullAlternative

Referenced models: Get permitted projects — response body — projects A list of projects item

Get permitted projects — response body — projects A list of projects item

FieldTypePresenceDescription and constraints
$objectRootThe identifiers for a project.
idJSONOptional
id (anyOf 1)JSONAlternative
id (anyOf 1) (anyOf 1)integerAlternativeThe ID of the project.
Format: int64
Read only: true
id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
id (anyOf 2)nullAlternative
keyJSONOptional
key (anyOf 1)stringAlternativeThe key of the project.
Read only: true
key (anyOf 2)nullAlternative

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.