GET/permissions

Edit online

By using GET/permissions API, you can retrieve a list of permissions (success) or gives a reason why it’s not possible (failure).

Authentication

Organization User (CustomerEmployee)

Delegated User (EndUser)

Service Account

Required Permissions

Permissions:Read: Always required.

Authorizations

Bearer Token: To authenticate API requests.

Parameters

limit

paginationToken: Minimum length: 1

Request body

{
curl --request GET \
  --url https://api.digitalassets.ibm.com/permissions \
  --header 'Authorization: Bearer <token>'
}'

Response

200: Success

{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "operations": [
        "<string>"
      ],
      "status": "Active",
      "isImmutable": true,
      "isArchived": true,
      "dateCreated": "<string>",
      "dateUpdated": "<string>",
      "pendingChangeRequest": {
        "id": "<string>",
        "requester": {
          "userId": "<string>",
          "tokenId": "<string>",
          "appId": "<string>"
        },
        "status": "Applied",
        "entityId": "<string>",
        "dateCreated": "2023-11-07T05:31:56Z",
        "kind": "Permission",
        "operationKind": "Update",
        "body": {
          "id": "<string>",
          "name": "<string>",
          "status": "Active",
          "operations": [
            "<string>"
          ],
          "isImmutable": true,
          "isArchived": true
        },
        "dateResolved": "2023-11-07T05:31:56Z",
        "approvalId": "<string>"
      }
    }
  ],
  "nextPageToken": "<string>"
}