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
- 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.
- Shop Creative Hub limits: 50 per upload, 10k a month, batch math
Creative Hub for GMV Max takes 50 videos per upload and 10k a month. What that means for Sume bulk queues of 100, and where the 200-video link cap bites.
- Shorts ad copy: 40-character headline, 90-character description
Google recommends 40-character headlines and 90-character descriptions for the Shorts ad CTA card. Draft copy in bulk with Sume and check lengths before upload.
- Ready-made Formats for product video: the Sume Format catalog
Sume ships ready-made Formats for product and UGC-style video and images, each callable from your backend with one HTTP request at the reserved sume handle.
Written by Sume