View the permissions of a role

You can view the information of a role and display the permissions that make it up via the console or the API.

Permissions

info

This action requires the following IAM (Identity and Access Management) permissions:

• iam.role.create

console

From the left-hand side menu, click IAM Identity and access → Roles to access the list of roles.

Click the name of a role to display its details and the list of associated permissions.

api

Obtain the mapping between role names and their UUID (Universally Unique Identifier)

List the roles of an organization

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/organisations/{organisationId}/roles

curl 'https://api.{region}.numspot.com/iam/organisations/{organisationId}/roles'

Example response:

{
  "nextPageToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "totalSize": 150,
  "items": [
    {
      "name": "…",
      "description": "…",
      "tenantType": [
        "organisation"
      ],
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2025-12-16T11:56:58.617Z",
      "updatedOn": "2025-12-16T11:56:58.617Z",
      "custom": true
    }
  ]
}

List the roles of a space

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/spaces/{spaceId}/roles

curl 'https://api.{region}.numspot.com/iam/spaces/{spaceId}/roles'

Example response:

{
  "nextPageToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "totalSize": 85,
  "items": [
    {
      "name": "…",
      "description": "…",
      "tenantType": [
        "space"
      ],
      "uuid": "987f6543-e21b-43d3-b765-543210987654",
      "createdOn": "2025-12-18T09:23:12.432Z",
      "updatedOn": "2025-12-18T09:23:12.432Z",
      "custom": false
    }
  ]
}

Retrieve the list of permissions that make up a role identified by its UUID

https://docs.numspot.com/openapi/#tag/identity-access-management/GET/iam/spaces/{spaceId}/roles/{roleUuid}/permissions

curl 'https://api.{region}.numspot.com/iam/spaces/{spaceId}/roles/{roleUuid}/permissions'

Example response:

{
  "nextPageToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "totalSize": 150,
  "items": [
    {
      "name": "…",
      "description": "…",
      "service": "resourcemanager",
      "resource": "storage",
      "subResource": "buckets",
      "action": "delete",
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2025-12-16T11:56:58.617Z",
      "updatedOn": "2025-12-16T11:56:58.617Z"
    }
  ]
}

info

See the page on using the API for the implementation.