Tarea completada

Se activa cuando una tarea de IA alcanza un estado terminal, tanto si tuvo éxito como si no.

POST task.completed

Token Bearer

curl 'https://api.ferndesk.com/v1/task.completed' \
  --request POST \
  --header 'webhook-id: whevt_01JXYC5R2K9M' \
  --header 'webhook-timestamp: 1752096000' \
  --header 'webhook-signature: v1,K5oT8v...base64...' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "whevt_01JXYC5R2K9M",
  "type": "task.completed",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "tsk_01JXYAQ4M7RC",
    "title": "Create API key onboarding docs",
    "status": "completed",
    "output_summaries": [
      {
        "id": "art_01JXY9AZK4KV",
        "url": "https://docs.example.com/getting-started-api-keys-A1B2C3",
        "title": "Getting started with API keys"
      }
    ]
  }
}'

Esta respuesta no tiene cuerpo.

Entrega confirmada; cualquier otra respuesta se reintenta con retroceso.

Cabeceras

· 3

webhook-id string obligatorio

id del sobre, único por evento.

webhook-timestamp string obligatorio

Segundos Unix en los que se firmó la solicitud; rechace los valores obsoletos.

webhook-signature string obligatorio

Tokens v1, separados por espacios — varios durante la rotación del secreto — calculados como se describe en Verificación de firma.

Cuerpo

obligatorio application/json

id string obligatorio

Identificador del evento, repetido en el encabezado webhook-id.

type string · enumeración obligatorio

Tipo de evento incluido en esta entrega.

valores

task.completed

created_at string obligatorio

Cuándo se creó el evento.

data object obligatorio

Cabeceras

Cuerpo

Respuestas