{
"info": {
"_postman_id": "1a96d778-014c-4be3-83ba-84517f100013",
"name": "Atlassian rest/api/3/permissions/",
"description": "Needs description.\n\nContact Support:\n Email: ecosystem@atlassian.com",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"createdAt": "2026-06-05T15:08:34.000Z",
"updatedAt": "2026-06-05T15:08:34.000Z",
"lastUpdatedBy": "35240",
"uid": "35240-1a96d778-014c-4be3-83ba-84517f100013"
},
"item": [
{
"name": "rest",
"item": [
{
"name": "api",
"item": [
{
"name": "3",
"item": [
{
"name": "permissions",
"item": [
{
"name": "check",
"item": [
{
"name": "Atlassian Get Bulk Permissions",
"id": "f8eb02a8-8945-4912-8993-772d06154efa",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"auth": {
"type": "noauth"
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/BulkPermissionsRequestBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/check",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"check"
]
},
"description": "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.
**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](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) 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."
},
"response": [
{
"id": "f06fb951-97d2-413f-b808-73c8642f6855",
"name": "Returned if the request is successful.",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/BulkPermissionsRequestBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/check",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"check"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"globalPermissions\": [\n \"\",\n \"\"\n ],\n \"projectPermissions\": [\n {\n \"value\": \"reference #/components/schemas/BulkProjectPermissionGrants not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/components/schemas/BulkProjectPermissionGrants not found in the OpenAPI spec\"\n }\n ]\n}",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-f06fb951-97d2-413f-b808-73c8642f6855"
},
{
"id": "ca764978-b3c5-40d9-bdb4-3339e6d2402f",
"name": "Returned if:\n\n * `projectPermissions` is provided without at least one project permission being provided.\n * an invalid global permission is provided in the global permissions list.\n * an invalid project permission is provided in the project permission",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/BulkPermissionsRequestBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/check",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"check"
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"value\": \"reference #/components/schemas/ErrorCollection not found in the OpenAPI spec\"\n}",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-ca764978-b3c5-40d9-bdb4-3339e6d2402f"
},
{
"id": "538f8776-f815-4f23-8da0-05700f55087c",
"name": "Returned if the user does not have the necessary permission.",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/BulkPermissionsRequestBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/check",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"check"
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"value\": \"reference #/components/schemas/ErrorCollection not found in the OpenAPI spec\"\n}",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-538f8776-f815-4f23-8da0-05700f55087c"
}
],
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-f8eb02a8-8945-4912-8993-772d06154efa"
}
],
"id": "a5e03af2-f80e-4d81-a158-7da1f585dd3f",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-a5e03af2-f80e-4d81-a158-7da1f585dd3f"
},
{
"name": "project",
"item": [
{
"name": "Atlassian Get Permitted Projects",
"id": "ea6f56c0-ac5c-4921-958b-9280a6ac6a0f",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"auth": {
"type": "noauth"
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/PermissionsKeysBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/project",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"project"
]
},
"description": "Returns all the projects where the user is granted a list of project permissions.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** None."
},
"response": [
{
"id": "31da270c-5251-4b81-aeba-8cd0dda7c148",
"name": "Returned if the request is successful.",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/PermissionsKeysBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/project",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"project"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"projects\": [\n {\n \"value\": \"reference #/components/schemas/ProjectIdentifierBean not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/components/schemas/ProjectIdentifierBean not found in the OpenAPI spec\"\n }\n ]\n}",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-31da270c-5251-4b81-aeba-8cd0dda7c148"
},
{
"id": "275d56ad-163a-4f92-863e-0f3d01eed53c",
"name": "Returned if a project permission is not found.",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/PermissionsKeysBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/project",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"project"
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "text",
"header": [],
"cookie": [],
"responseTime": null,
"body": null,
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-275d56ad-163a-4f92-863e-0f3d01eed53c"
},
{
"id": "20b411ec-3eef-4c10-85bf-7e26be516068",
"name": "Returned if the authentication credentials are incorrect or missing.",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"value\": \"reference #/components/schemas/PermissionsKeysBean not found in the OpenAPI spec\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/rest/api/3/permissions/project",
"host": [
"{{baseUrl}}"
],
"path": [
"rest",
"api",
"3",
"permissions",
"project"
]
}
},
"status": "Unauthorized",
"code": 401,
"_postman_previewlanguage": "text",
"header": [],
"cookie": [],
"responseTime": null,
"body": null,
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-20b411ec-3eef-4c10-85bf-7e26be516068"
}
],
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-ea6f56c0-ac5c-4921-958b-9280a6ac6a0f"
}
],
"id": "666d8344-23ae-4c91-81a2-d32151cd82eb",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-666d8344-23ae-4c91-81a2-d32151cd82eb"
}
],
"id": "dc4a9f0e-641b-469a-b46d-d25713a3168a",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-dc4a9f0e-641b-469a-b46d-d25713a3168a"
}
],
"id": "153d92cf-c23a-40ac-899d-ee8196bc5dd1",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-153d92cf-c23a-40ac-899d-ee8196bc5dd1"
}
],
"id": "2c79aa9c-4250-43af-a146-f64fde265c54",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-2c79aa9c-4250-43af-a146-f64fde265c54"
}
],
"id": "0dcb0e7f-79ce-44ed-923a-544753fb1227",
"createdAt": "2026-06-05T15:08:35.000Z",
"updatedAt": "2026-06-05T15:08:35.000Z",
"uid": "35240-0dcb0e7f-79ce-44ed-923a-544753fb1227"
}
],
"variable": [
{
"key": "baseUrl",
"value": "https://your-domain.atlassian.net"
}
]
}