Skip to content
StraventaDocs
Now in Sandbox.

List registered permissions

Returns the full catalogue of registered platform and tenant permissions. Read-only; no pagination.

GET
/v1/admin/permissions

Returns the full catalogue of registered platform and tenant permissions. Read-only; no pagination.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT Bearer access token. Clock skew tolerance is ±60 seconds.

In: header

Query Parameters

sort?string

Column to order the permission catalogue by. Defaults to service ascending. status orders by the deprecated flag. The per-role grant columns are not sortable and return 400 invalid_sort_key.

Value in"service" | "key" | "description" | "status"
order?string

Sort direction. Ignored unless sort is supplied; an unrecognised value returns 400 invalid_sort_order.

Value in"asc" | "desc"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/admin/permissions?sort=service&order=asc"
{
  "permissions": [
    {
      "id": "018f1a2b-0001-7000-8000-000000000010",
      "code": "platform.user.read",
      "description": "Read user records across tenants"
    }
  ]
}
{
  "error": "unauthenticated",
  "message": "missing or invalid bearer token",
  "request_id": "req_01abc123"
}
{
  "error": "permission_denied",
  "message": "caller does not hold the required permission",
  "request_id": "req_01abc124"
}

Was this page helpful?