Skip to main content
GET
https://api.trillet.ai
/
v1
/
api
/
roles-and-permissions
/
permissions
List Available Permissions
curl --request GET \
  --url https://api.trillet.ai/v1/api/roles-and-permissions/permissions \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
[
  {
    "key": "agent_view",
    "name": "View Agents",
    "description": "View agent configurations and details",
    "category": "agents"
  },
  {
    "key": "agent_create",
    "name": "Create Agents",
    "description": "Create new agents",
    "category": "agents"
  },
  {
    "key": "call_history_view",
    "name": "View Call History",
    "description": "View call history records and transcripts",
    "category": "calls"
  }
]

​
Headers

​
x-api-key
string
required
API key used for authenticating requests to the API.
​
x-workspace-id
string
required
Workspace identifier for the API.

​
Response Fields

​
permissions
array
Array of permission objects grouped by category.
​
key
string
Unique permission key (e.g., “agent_view”, “call_history_export”).
​
name
string
Human-readable permission name.
​
description
string
Description of what the permission allows.
​
category
string
Permission category (e.g., “agents”, “calls”, “workspace”, “flows”).
[
  {
    "key": "agent_view",
    "name": "View Agents",
    "description": "View agent configurations and details",
    "category": "agents"
  },
  {
    "key": "agent_create",
    "name": "Create Agents",
    "description": "Create new agents",
    "category": "agents"
  },
  {
    "key": "call_history_view",
    "name": "View Call History",
    "description": "View call history records and transcripts",
    "category": "calls"
  }
]