> ## 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.

# Get Role

> Retrieve a specific role by its ID.

## 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>

## Path Parameters

<ParamField path="roleId" type="string" required>
  The unique identifier of the role.
</ParamField>

## Response Fields

<ResponseField name="_id" type="string">
  Unique identifier for the role.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the role.
</ResponseField>

<ResponseField name="description" type="string">
  Description of the role.
</ResponseField>

<ResponseField name="permissions" type="array">
  Array of permission objects assigned to the role.
</ResponseField>

<ResponseField name="userIds" type="array">
  Array of user IDs assigned to this role.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "_id": "665a1b2c3d4e5f6a7b8c9d0e",
    "name": "Agent Manager",
    "description": "Can manage agents and view call history",
    "permissions": [
      { "key": "agent_view", "category": "agents" },
      { "key": "agent_create", "category": "agents" },
      { "key": "agent_edit", "category": "agents" }
    ],
    "userIds": ["user_001"]
  }
  ```
</ResponseExample>