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

# Obter agente

> Recuperar um agente de IA pelo ID.

# Obter agente

Retorna os detalhes completos de um agente específico.

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

**Escopo necessário:** `chatbots:read`

***

## Path parameters

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `chatbot_id` | string | ID do agente |

***

## Resposta

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "bot_abc123",
    "name": "Suporte ao cliente",
    "description": "Agente para perguntas gerais",
    "system_prompt": "Você é o assistente virtual da Acme Corp...",
    "model": "claude-sonnet-4-6",
    "temperature": 0.3,
    "max_tokens": 1000,
    "is_active": true,
    "is_published": true,
    "widget_config": {
      "primaryColor": "#00ed64",
      "greeting": "Olá! Como posso ajudar você?",
      "leadCapture": false
    },
    "created_at": "2025-03-20T14:30:00.000Z",
    "updated_at": "2025-06-01T09:15:00.000Z"
  }
}
```

***

## Erros comuns

| Code | Descrição |
| - | - |
| `NOT_FOUND` | O agente não existe ou não pertence à sua organização |


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