Snapgen Org Webhooks

generated: '2026-11-09'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.snapgen.org/api-reference/webhooks.md
sources:
- https://docs.snapgen.org/api-reference/webhooks.md
description: SnapGen sends a single signed POST webhook when a task reaches a final state.
events:
- event: task.succeeded
  description: Sent when the task reaches a final succeeded state; the payload contains the task result under `data.task.result`.
- event: task.failed
  description: Sent when the task reaches a final failed state; `data.task.error` includes a `code` and a `message`.
- event: task.expired
  description: Sent when the task expires before completing; `data.task.error` includes a `code` and a `message`.
- event: task.reconciliation_required
  description: Sent when the final outcome isn’t confirmed yet; check `GET /v1/tasks/{id}` later and do not resubmit the job.
delivery:
  signature: HMAC‑SHA256 of `<timestamp>.<raw body>` keyed with the `webhook_secret`, hex‑encoded and prefixed with `v1=`; timestamp provided
    in `X-Gateway-Webhook-Timestamp` header.
  retries: 'Up to 12 attempts. Retries on timeouts, connection errors, 408, 409, 425, 429, and 5xx responses. First retry after a few seconds,
    then exponential back‑off (doubling) up to ~1 hour with jitter; final attempt ~1–2.5 hours after the first. A `Retry-After` response header
    can adjust the wait (max 1 hour). Non‑retryable: any other 4xx, any 3xx, or TLS certificate errors. Deliveries must return any 2xx within
    10 seconds to be acknowledged.'
note: Each delivery includes headers `X-Gateway-Event`, `X-Gateway-Webhook-Id`, `Idempotency-Key`, `X-Gateway-Webhook-Timestamp`, and `X-Gateway-Webhook-Signature`
  for verification and deduplication.
docs: https://docs.snapgen.org/api-reference/webhooks.md