Agentes · Pausar / reactivar
Pausar o reactivar un agente
Endpoint
POST
https://claix.dev/agents/pause/{agent_id}Cambia el estado de un agente entre paused y active. Un agente pausado no acepta llamadas a /retrieve/{slug}.
Esta llamada es gratuita.
1. Autenticación
x-api-key: <TU_API_KEY>
2. Formato de la petición
Método: POST · Content-Type: application/json
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| agent_id (URL) | uuid | Sí | En /agents/pause/{agent_id}. También se admite en el JSON. |
| status | string | Sí | "paused" para pausar, "active" para reactivar. |
{ "status": "paused" }3. Ejemplos
En el panel derecho hay pestañas para pausar y para reactivar.
4. Respuesta exitosa
200 OK
{
"success": true,
"action": "paused",
"agent": {
"agent_id": "9d8e7f6a-5b4c-3d2e-1f0a-9b8c7d6e5f4a",
"name": "Asistente de agenda",
"slug": "agenda",
"status": "paused",
"retrieve_url": "https://claix.dev/retrieve/agenda"
}
}5. Errores
| HTTP | Cuándo |
|---|---|
| 401 | API key inválida. |
| 404 | Agente no encontrado. |
| 400 | Falta status o agent_id, o valor 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"
}