Permissions

List permissions

Changed on

List the full catalog of permission strings recognized by the role system. Use this to discover valid values for the permissions array on Create Role and Update Role.

Requires authentication, but no specific permission — any valid API key can read the catalog. The catalog is the same for every account.

get/api/v1/permissions

Request

  • Base URL
    https://api.rafftechnologies.com
  • URL
    https://api.rafftechnologies.com/api/v1/permissions
  • Auth
    API key in header X-API-Key

Query parameters

scope'account' | 'project'

Filter by scope

Response

List of permissions

successboolean

Example response

{
  "data": [
    {
      "name": "vm.create",
      "description": "Create new virtual machines",
      "category": "vm"
    }
  ]
}

Changes