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

# Get agent

> Retrieve an AI agent by its ID.

# Get agent

Returns the full details of a specific agent.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}
Authorization: Bearer <your_api_key>
```

**Required scope:** `chatbots:read`

***

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `chatbot_id` | string | Agent ID |

***

## Response

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "bot_abc123",
    "name": "Customer support",
    "description": "Agent for general questions",
    "system_prompt": "You are Acme Corp's virtual assistant...",
    "model": "claude-sonnet-4-6",
    "temperature": 0.3,
    "max_tokens": 1000,
    "is_active": true,
    "is_published": true,
    "widget_config": {
      "primaryColor": "#00ed64",
      "greeting": "Hi! How can I help you?",
      "leadCapture": false
    },
    "created_at": "2025-03-20T14:30:00.000Z",
    "updated_at": "2025-06-01T09:15:00.000Z"
  }
}
```

***

## Common errors

| Code | Description |
| - | - |
| `NOT_FOUND` | The agent doesn't exist or doesn't belong to your organization |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.