Framelane Io Webhooks

generated: '2026-10-30'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.framelane.io/webhooks/overview.md
sources:
- https://docs.framelane.io/webhooks/overview.md
- https://docs.framelane.io/webhooks/events.md
- https://docs.framelane.io/webhooks/signature-verification.md
- https://docs.framelane.io/webhooks/retry-schedule.md
description: Framelane webhooks deliver HMAC‑SHA256 signed JSON payloads via HTTPS POST. The endpoint must return a 2xx response within 10 seconds
  or the delivery is considered failed and retried.
events:
- event: render.queued
  description: Render job accepted and queued.
- event: render.processing
  description: GPU engine started processing.
- event: render.progress
  description: Progress update (multiple per job).
- event: render.completed
  description: Render finished, artifact ready.
- event: render.failed
  description: Render failed with an error.
- event: render.cancelled
  description: Render was cancelled.
- event: task.queued
  description: Task accepted and queued.
- event: task.processing
  description: Task started processing.
- event: task.completed
  description: Task finished, artifact ready.
- event: task.failed
  description: Task failed with an error.
- event: asset.ready
  description: Media metadata extracted after upload or import (duration, width, height).
- event: webhook.test
  description: Sent by the test endpoint.
delivery:
  signature: X-Render-Signature (sha256=<hex>) computed as HMAC‑SHA256(secret, "{X-Render-Timestamp}.{raw_body}")
  retries: 'Exponential back‑off schedule: attempt 2 after 30 s, 3 after 5 min, 4 after 30 min, 5 after 2 h, 6 after 8 h, 7 after 24 h; after
    7 attempts the delivery is dead‑lettered.'
  content_type: application/json
note: No additional authentication header is sent with each delivery; verification relies on the HMAC signature using the workspace‑level secret
  returned when the webhook is created.
docs: https://docs.framelane.io/webhooks/overview.md