---
title: "List Available Permissions"
api: "GET /v1/api/roles-and-permissions/permissions"
description: "Retrieve all available permissions that can be assigned to roles."
---

## Headers
<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
[
  {
    "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>