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

# Atualizar agente

> Modificar a configuração de um agente de IA existente.

# Atualizar agente

Atualiza um ou mais campos de um agente. Apenas os campos incluídos no corpo são modificados — os demais permanecem sem alterações.

```http theme={null}
PATCH https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}
Authorization: Bearer <sua_api_key>
Content-Type: application/json
```

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

***

## Path parameters

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

***

## Corpo da request

Todos os campos são opcionais. Apenas os campos incluídos são atualizados.

| Campo | Tipo | Descrição |
| - | - | - |
| `name` | string | Nome do agente (1–100 caracteres) |
| `description` | string \| null | Descrição do agente (máx. 500 caracteres) |
| `system_prompt` | string | Instruções do sistema |
| `model` | string | Modelo de IA (ex.: `claude-sonnet-4-6`, `gpt-4o`) |
| `temperature` | number | Temperatura entre `0` e `1` |
| `max_tokens` | integer | Máximo de tokens da resposta (100–4096) |
| `is_active` | boolean | Se o agente está ativo |
| `widget_config` | object | Configuração visual do widget (substitui por completo) |

### Exemplo

```json theme={null}
{
  "system_prompt": "Você é o assistente da Acme Corp. Responda sempre em português.",
  "temperature": 0.4,
  "model": "claude-haiku-4-5-20251001"
}
```

***

## Resposta

Retorna o agente com todos os campos atualizados.

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "bot_abc123",
    "name": "Suporte ao cliente",
    "description": null,
    "system_prompt": "Você é o assistente da Acme Corp. Responda sempre em português.",
    "model": "claude-haiku-4-5-20251001",
    "temperature": 0.4,
    "max_tokens": 1000,
    "is_active": true,
    "is_published": true,
    "widget_config": { ... },
    "created_at": "2025-03-20T14:30:00.000Z",
    "updated_at": "2026-06-30T18:30:00.000Z"
  }
}
```

***

## Erros comuns

| Code | Descrição |
| - | - |
| `INVALID_INPUT` | Um campo não passa na validação (ex.: `temperature` fora do intervalo) |
| `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.