Task completed

Fires when an AI task reaches a terminal status, whether it succeeded or not.

POST task.completed

Bearer token

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"
      }
    ]
  }
}'

This response has no body.

Delivery acknowledged; anything else is retried with backoff.

Headers

· 3

webhook-id string required

Envelope id, unique per event.

webhook-timestamp string required

Unix seconds when the request was signed; reject stale values.

webhook-signature string required

Space-separated v1, tokens — several during secret rotation — computed as described under Signature verification.

Body

required application/json

id string required

Event identifier, repeated in the webhook-id header.

type string · enum required

Event type carried by this delivery.

values

task.completed

created_at string required

When the event was created.

data object required

Headers

Body

Responses