Skip to main content

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.
PATCH https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}
Authorization: Bearer <tu_api_key>
Content-Type: application/json
Scope requerido: chatbots:write

Path parameters

ParámetroTipoDescripción
chatbot_idstringID del agente a actualizar

Cuerpo de la request

Todos los campos son opcionales. Solo se actualizan los campos incluidos.
CampoTipoDescripción
namestringNombre del agente (1–100 caracteres)
descriptionstring | nullDescripción del agente (máx. 500 caracteres)
system_promptstringInstrucciones del sistema
modelstringModelo de IA (ej. claude-sonnet-4-6, gpt-4o)
temperaturenumberTemperatura entre 0 y 1
max_tokensintegerTokens máximos de respuesta (100–8192)
is_activebooleanSi el agente está activo
widget_configobjectConfiguración visual del widget (reemplaza completo)

Ejemplo

{
  "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.
{
  "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

CodeDescripción
INVALID_INPUTUn campo no pasa la validación (ej. temperature fuera de rango)
NOT_FOUNDEl agente no existe o no pertenece a tu organización