List API key roles

Retrieve all available API key roles. Roles are predefined permission sets that can be assigned to API keys. This is reference data and does not require specific resource permissions.

GET /resources/rbac/api-key-roles

List API key roles

cURL

curl --request GET \
  --url https://api.sevalla.com/v3/resources/rbac/api-key-roles \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "fb5e5168-4281-4bec-94c5-0d1584e9e657",
    "name": "Developer",
    "description": "Can manage applications and databases",
    "permissions": [
      "fb5e5168-4281-4bec-94c5-0d1584e9e657"
    ]
  }
]

Authorizations

Authorization · string · header · required

API key authentication. Pass your API key as a Bearer token in the Authorization header.

Response

200

application/json

List of available API key roles

id · string<uuid> · required

Unique identifier for the role

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Example:

"fb5e5168-4281-4bec-94c5-0d1584e9e657"

name · string · required

Name of the role

Example:

"Developer"

description · string · required

Human-readable description of what this role allows

Example:

"Can manage applications and databases"

permissions · string[] · required

List of permission IDs granted by this role

Example:

["fb5e5168-4281-4bec-94c5-0d1584e9e657"]