Task event webhook

Dikirim ke webhook_url (per task, atau default project) pada setiap perubahan status: task.processing, task.succeeded, task.failed, task.cancelled.

  • Signature: header X-Run-Signature berformat t=<unix_ts>,v1=<hex> — HMAC SHA-256 atas "{t}.{raw_body}" dengan signing secret project. Tolak bila selisih t dengan waktu sekarang melebihi toleransi (rekomendasi 5 menit).
  • Balas HTTP 2xx untuk menandai sukses; selain itu dikirim ulang dengan exponential backoff.
  • Delivery duplikat mungkin terjadi — gunakan id event untuk dedup.
postWebhooktaskEvent

Payload

idstring required
type'task.processing' | 'task.succeeded' | 'task.failed' | 'task.cancelled' required
created_atstring date-time required
attemptinteger required

Nomor attempt delivery, mulai dari 1.

Example payload

{
  "id": "evt_01J8Z3N0V9X2M4K6P8Q0R2S4T6",
  "data": {
    "id": "task_01J8Z3N0V9X2M4K6P8Q0R2S4T6",
    "model": "google/veo-3.1",
    "price": {
      "estimated": 22500,
      "reserved": 22500
    }
  }
}

Response

Diterima client.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.