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

# Get Agent

Retrieve the full configuration details of a specific agent.

### Headers

<ParamField header="X-API-Key" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField header="X-Organization-Id" type="string" required>
  The organization ID.
</ParamField>

### Path Parameters

<ParamField path="agent_id" type="string" required>
  The unique identifier of the agent (format: `agent_[a-f0-9]{12,}`).
</ParamField>

### Permissions

* `agents:read` (all roles)

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  The full agent configuration object.

  <Expandable title="properties">
    <ResponseField name="agent_id" type="string">
      Unique agent identifier.
    </ResponseField>

    <ResponseField name="agent_name" type="string">
      The name of the agent.
    </ResponseField>

    <ResponseField name="language" type="string">
      Primary language code (e.g., `EN`, `ES`).
    </ResponseField>

    <ResponseField name="stt_provider" type="string">
      Speech-to-Text provider (e.g., `deepgram`, `aws`).
    </ResponseField>

    <ResponseField name="tts_provider" type="string">
      Text-to-Speech provider (e.g., `elevenlabs`, `cartesia`, `deepgram`).
    </ResponseField>

    <ResponseField name="tts_voice" type="string">
      Voice ID for the selected TTS provider.
    </ResponseField>

    <ResponseField name="llm_provider" type="string">
      LLM provider (e.g., `openai`, `anthropic`, `google`).
    </ResponseField>

    <ResponseField name="llm_model" type="string">
      Model ID (e.g., `gpt-4o`, `gemini-2.5-flash-lite`).
    </ResponseField>

    <ResponseField name="system_prompt" type="string">
      The system prompt defining the agent's persona.
    </ResponseField>

    <ResponseField name="speak_first" type="boolean">
      Whether the agent speaks first when call connects.
    </ResponseField>

    <ResponseField name="end_call_tool" type="boolean">
      Whether the end call tool is enabled.
    </ResponseField>

    <ResponseField name="llm_temperature" type="number">
      LLM temperature setting (0.0 to 2.0).
    </ResponseField>

    <ResponseField name="llm_fallback_provider" type="string">
      Fallback LLM provider.
    </ResponseField>

    <ResponseField name="llm_fallback_model" type="string">
      Fallback LLM model.
    </ResponseField>

    <ResponseField name="recording_enabled" type="boolean">
      Whether call recording is enabled.
    </ResponseField>

    <ResponseField name="voicemail_detection" type="boolean">
      Whether answering machine detection is enabled.
    </ResponseField>

    <ResponseField name="voicemail_message" type="string">
      Message to leave on voicemail.
    </ResponseField>

    <ResponseField name="voicemail_response_delay" type="number">
      Delay in seconds before leaving voicemail message (1.0-5.0).
    </ResponseField>

    <ResponseField name="custom_tools" type="array">
      List of attached tool IDs.
    </ResponseField>

    <ResponseField name="kb_document_ids" type="array">
      List of attached knowledge base document IDs.
    </ResponseField>

    <ResponseField name="assigned_phone_number_ids" type="array">
      List of assigned phone number IDs.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of last update.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "agent_id": "agent_a1b2c3d4e5f6",
      "agent_name": "Sales Rep",
      "language": "EN",
      "stt_provider": "deepgram",
      "tts_provider": "elevenlabs",
      "tts_voice": "21m00Tcm4TlvDq8ikWAM",
      "llm_provider": "openai",
      "llm_model": "gpt-4o",
      "system_prompt": "You are a helpful sales representative...",
      "speak_first": true,
      "end_call_tool": true,
      "llm_temperature": 0.7,
      "recording_enabled": true,
      "voicemail_detection": false,
      "voicemail_response_delay": 2.0,
      "custom_tools": [],
      "kb_document_ids": [],
      "assigned_phone_number_ids": [],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:45:00Z"
    }
  }
  ```
</ResponseExample>