Get bulk permissions

Returns:

for a list of global permissions, the global permissions granted to a user.

for a list of project permissions and lists of projects and issues, for each project permission a list of the projects and issues a user can access or manipulate.

If no account ID is provided, the operation returns details for the logged in user.

Note that:

Invalid project and issue IDs are ignored.

A maximum of 1000 projects and 1000 issues can be checked.

Null values in globalPermissions, projectPermissions, projectPermissions.projects, and projectPermissions.issues are ignored.

Empty strings in projectPermissions.permissions are ignored.

This operation can be accessed anonymously.

Permissions required: Administer Jira global permission to check the permissions for other users, otherwise none. However, Connect apps can make a call from the app server to the product to obtain permission details for any user, without admin permission. This Connect app ability doesn't apply to calls made using AP.request() in a browser.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/permissions/check' \ --header 'Content-Type: application/json' \ --data-raw '{ "accountId": "5b10a2844c20165700ede21g", "globalPermissions": [ "ADMINISTER" ], "projectPermissions": [ { "issues": [ 10010, 10011, 10012, 10013, 10014 ], "permissions": [ "EDIT_ISSUES" ], "projects": [ 10001 ] } ] }'

Request

Body Params application/json

Details of global permissions to look up and project permissions with associated projects and issues to look up.

accountId

string

optional

The account ID of a user.

globalPermissions

array[string]

optional

Global permissions to look up.

projectPermissions

array[object (BulkProjectPermissions) {3}]

optional

Project permissions with associated projects and issues to look up.

issues

array[integer <int64>]

optional

List of issue IDs.

permissions

array[string]

required

List of project permissions.

projects

array[integer <int64>]

optional

List of project IDs.

Examples

Responses

🟢200Returned if the request is successful.

application/json

Body

Details of global and project permissions granted to the user.

globalPermissions

array[string]

required

List of permissions granted to the user.

projectPermissions

array[object (BulkProjectPermissionGrants) {3}]

required

List of project permissions and the projects and issues those permissions provide access to.

issues

array[integer <int64>]

required

IDs of the issues the user has the permission for.

permission

string

required

A project permission,

projects

array[integer <int64>]

required

IDs of the projects the user has the permission for.

🟠400Returned if: * `projectPermissions` is provided without at least one project permission being provided. * an invalid global permission is provided in the global permissions list. * an invalid project permission is provided in the project permission

🟠403Returned if the user does not have the necessary permission.