Sume webhook missed? POST /v1/format-runs/{run_id}/webhook/redeliver
Replay a Format run webhook without rerunning: the redeliver endpoint, the formats:write scope, and the two 409 errors for no webhook or a run still going.
If your receiver was down, replay the delivery instead of rerunning the Format. POST /v1/format-runs/{run_id}/webhook/redeliver sends a fresh receipt with a new timestamp and signature, signed with the same secret. It needs the formats:write scope. It answers 409 webhook_not_configured when the run never had a communication.webhook_url, and 409 run_not_terminal when the run is still going.
Automatic delivery already retries up to 10 times with a 10 second timeout per attempt and backoff capped at one hour; redirects count as failures. Canceled and skipped runs never deliver, so redelivery is not a way to get a canceled run to speak.
Errors
| Case | Response |
|---|---|
| No webhook_url on the run | 409 webhook_not_configured |
| Run still queued or processing | 409 run_not_terminal |
| Terminal run with webhook | New signed delivery |
Large receipts
A receipt over 1 MiB arrives as payload: null with payload_too_large and a result_url. Fetch the result there. Redelivery behaves the same.
Sources
Related posts
More in Formats
- SumeMediaFile duration_ms is checked within 10% of the real file
A duration_ms in Format output must match the run's artifact ledger within 10%, or the projection fails. A null means not measured, not zero.
- Sume SDK subscribeFormatRun: 20-minute timeout vs 90-minute runs
subscribeFormatRun in @sume-com/sdk polls every 2 seconds and times out at 20 minutes by default, while a Format run can live 90. Set the timeout on purpose.
- sume-virtual-try-on Format: first frame, then Seedance 2.5
The sume-virtual-try-on Format builds a first frame with ChatGPT Image 2, then animates it with Seedance 2.5. What goes in, what comes back.
- Sume webhook retry schedule: 30s doubling, 10 tries, 1h cap
Sume Format run webhooks retry up to 10 times with min(max(30s x 2^(attempt-1), Retry-After), 1h). The arithmetic of that schedule and what to do when it ends.
Written by Sume