> ## Documentation Index
> Fetch the complete documentation index at: https://trilletai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Available Permissions

> Retrieve all available permissions that can be assigned to roles.

## Headers

<ParamField header="x-api-key" type="string" required>
  API key used for authenticating requests to the API.
</ParamField>

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

## Response Fields

<ResponseField name="permissions" type="array">
  Array of permission objects grouped by category.

  <ResponseField name="key" type="string">
    Unique permission key (e.g., "agent\_view", "call\_history\_export").
  </ResponseField>

  <ResponseField name="name" type="string">
    Human-readable permission name.
  </ResponseField>

  <ResponseField name="description" type="string">
    Description of what the permission allows.
  </ResponseField>

  <ResponseField name="category" type="string">
    Permission category (e.g., "agents", "calls", "workspace", "flows").
  </ResponseField>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  [
    {
      "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"
    }
  ]
  ```
</ResponseExample>