Agentes · Editar
Editar un agente por API
Endpoint
PUT
https://claix.dev/agents/edit/{agent_id}Actualiza nombre, slug, descripción, prompt, rutas y modo de respuesta de un agente de tu cuenta. Mismo cuerpo obligatorio que al crear. También admite POST.
Esta llamada es gratuita.
1. Autenticación
x-api-key: <TU_API_KEY>
2. Formato de la petición
El agent_id va en la URL. El cuerpo incluye todos los campos de creación:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| agent_id (URL) | uuid | Sí | En /agents/edit/{agent_id}. |
| name | string | Sí | Nombre visible. |
| slug | string | Sí | Slug único 3–20 (a-z0-9). |
| description | string | Sí | Descripción. |
| prompt | string | Sí | Instrucciones de negocio. |
| routes | uuid[] | Sí | Rutas de tu cuenta. |
| response_mode | string | Sí | bruto | razonada. |
3. Ejemplos
Panel derecho con ejemplos listos.
4. Respuesta exitosa
200 OK
{
"success": true,
"agent": {
"agent_id": "9d8e7f6a-5b4c-3d2e-1f0a-9b8c7d6e5f4a",
"name": "Asistente de agenda",
"slug": "agenda",
"description": "Responde preguntas sobre citas y pacientes de la clínica.",
"status": "active",
"prompt": "Eres el asistente de la clínica. Solo usas las rutas asignadas. No inventes datos.",
"routes": ["7c2f9a1e-4b8d-4e6a-9f21-0a1b2c3d4e5f"],
"response_mode": "bruto",
"retrieve_url": "https://claix.dev/retrieve/agenda",
"updated_at": "2026-10-19T19:00:00.000Z"
}
}5. Errores
| HTTP | Cuándo |
|---|---|
| 401 | API key inválida. |
| 404 | Agente inexistente o de otra cuenta. |
| 400 | Parámetro faltante o inválido. |
| 500 | Error interno. |
{
"error": "Descripción legible del problema.",
"detalle": "Información técnica adicional (solo presente en algunos casos).",
"log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}