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

# Listar agentes

> Obter a lista paginada de agentes de IA da sua organização.

# Listar agentes

Retorna todos os agentes de IA da sua organização, ordenados por data de criação decrescente.

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

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

***

## Query parameters

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `page` | integer | Número da página. Default: `1` |
| `per_page` | integer | Resultados por página. Default: `25`, máximo `100` |

***

## Resposta

```json theme={null}
{
  "status": "success",
  "data": {
    "chatbots": [
      {
        "id": "bot_abc123",
        "name": "Suporte ao cliente",
        "description": "Agente de suporte 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"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}
```

### Campos da resposta

| Campo | Tipo | Descrição |
| - | - | - |
| `id` | string | ID único do agente |
| `name` | string | Nome do agente |
| `description` | string \| null | Descrição opcional |
| `system_prompt` | string | Instruções do sistema |
| `model` | string | Modelo de IA configurado |
| `temperature` | number | Temperatura (0–1) |
| `max_tokens` | integer | Comprimento máximo da resposta |
| `is_active` | boolean | Se o agente está ativo |
| `is_published` | boolean | Se o agente está publicado (visível nos canais) |
| `widget_config` | object | Configuração visual do widget |
| `created_at` | string | Data de criação (ISO 8601) |
| `updated_at` | string | Última modificação (ISO 8601) |


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