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

# Actualizar agente

> Modificar la configuración de un agente de IA existente.

# Actualizar agente

Actualiza uno o más campos de un agente. Solo se modifican los campos que se incluyan en el cuerpo — los demás se mantienen sin cambios.

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

**Scope requerido:** `chatbots:write`

***

## Path parameters

| Parámetro    | Tipo   | Descripción                |
| ------------ | ------ | -------------------------- |
| `chatbot_id` | string | ID del agente a actualizar |

***

## Cuerpo de la request

Todos los campos son opcionales. Solo se actualizan los campos incluidos.

| Campo           | Tipo           | Descripción                                          |
| --------------- | -------------- | ---------------------------------------------------- |
| `name`          | string         | Nombre del agente (1–100 caracteres)                 |
| `description`   | string \| null | Descripción del agente (máx. 500 caracteres)         |
| `system_prompt` | string         | Instrucciones del sistema                            |
| `model`         | string         | Modelo de IA (ej. `claude-sonnet-4-6`, `gpt-4o`)     |
| `temperature`   | number         | Temperatura entre `0` y `1`                          |
| `max_tokens`    | integer        | Tokens máximos de respuesta (100–8192)               |
| `is_active`     | boolean        | Si el agente está activo                             |
| `widget_config` | object         | Configuración visual del widget (reemplaza completo) |

### Ejemplo

```json theme={null}
{
  "system_prompt": "Eres el asistente de Acme Corp. Respondé siempre en español.",
  "temperature": 0.4,
  "model": "claude-haiku-4-5-20251001"
}
```

***

## Respuesta

Devuelve el agente con todos los campos actualizados.

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "bot_abc123",
    "name": "Soporte al cliente",
    "description": null,
    "system_prompt": "Eres el asistente de Acme Corp. Respondé siempre en español.",
    "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"
  }
}
```

***

## Errores comunes

| Code            | Descripción                                                       |
| --------------- | ----------------------------------------------------------------- |
| `INVALID_INPUT` | Un campo no pasa la validación (ej. `temperature` fuera de rango) |
| `NOT_FOUND`     | El agente no existe o no pertenece a tu organización              |