v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Permissions

List permissions

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

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"
    }
  ]
}