Skip to content
StraventaDocs

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

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/admin/permissions"
{
  "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?