Aufgabe abgeschlossen

Wird ausgelöst, wenn eine AI-Aufgabe einen endgültigen Status erreicht, unabhängig davon, ob sie erfolgreich war.

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

Diese Antwort hat keinen Body.

Zustellung bestätigt; alles andere wird mit zunehmenden Wartezeiten erneut versucht.

Header

· 3

webhook-id string erforderlich

Envelope-id, eindeutig pro Ereignis.

webhook-timestamp string erforderlich

Unix-Sekunden, zu denen die Anfrage signiert wurde; veraltete Werte ablehnen.

webhook-signature string erforderlich

Durch Leerzeichen getrennte v1,-Tokens — mehrere während der Geheimnisrotation — berechnet wie unter Signaturprüfung beschrieben.

Body

erforderlich application/json

id string erforderlich

Ereigniskennung, wiederholt im Header webhook-id.

type string · Enum erforderlich

Ereignistyp dieser Zustellung.

Werte

task.completed

created_at string erforderlich

Zeitpunkt der Ereigniserstellung.

data object erforderlich

Header

Body

Antworten