POST /rest/api/2/permissions/check
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, andprojectPermissions.issuesare ignored. - Empty strings in
projectPermissions.permissionsare ignored.
Deprecation notice: The required OAuth 2.0 scopes will be updated on June 15, 2024.
- Classic:
read:jira-work - Granular:
read:permission:jira
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.
Servers
- https://your-domain.atlassian.net
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
accountId |
String | No |
The account ID of a user. |
globalPermissions[] |
Array | No |
Global permissions to look up. |
projectPermissions[] |
Array | No |
Project permissions with associated projects and issues to look up. |
projectPermissions[].projects[] |
Array | No |
List of project IDs. |
projectPermissions[].issues[] |
Array | No |
List of issue IDs. |
projectPermissions[].permissions[] |
Array | Yes |
List of project permissions. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.