Does a Format run webhook fire per clip? No, once per turn
A Format run sends one format.run.terminal webhook per agent turn, however many clips it made. A continued run is new and sends its own.

No. A Format run is one agent turn, so its terminal event fires exactly once, however many clips, images or files the turn made. Sume has no per-artifact run event and does not plan one (Run webhooks). Read the finished clips from artifacts[] on the receipt after the single event arrives.
What fires and when
The event of the first run already fired and does not fire again when you continue.
| You do | Webhook |
|---|---|
| Start a Format run | One format.run.terminal when it ends. |
Continue it with previous_run_id | A new run with a new id, and its own single event. |
| Start a scheduled run | One action.run.terminal. |
| Start an Agent Completion | One agent.run.terminal. |
If you need progress inside a turn
Use the generation-job layer (Webhooks). It fires one event per job when the job completes. Job events name a job, not a step of your recipe, so map a job to a scene on your side.
Handler checklist
- Route on the
eventname, and do not parse the body to find the run type. - Make the handler idempotent on the run id. A redelivery can reach you twice.
- On a continued run, expect a different run id and the same
thread_id. - Poll
GET /v1/format-runs/{run_id}if the event never arrives.
Sources
Related posts
More in Formats
- Sume Format webhook: verify the timestamp, register the final URL
Sume signs format.run.terminal with HMAC-SHA256, expects a response in 10 seconds, retries up to 10 times and does not follow redirects. Register the final URL.
- Free plan 120 writes a minute: a 100-item bulk queue is one request
A Sume bulk create is one POST against the write budget, and polling spends the separate read budget. Here are the per-plan limits and what that means.
- Localize one Sume Format into six languages: one bulk item each
To make one ad in six languages, send six items to one Sume bulk queue with the language in input and one Idempotency-Key scheme. Here is the shape and limits.
- Log format.version on every bulk child: which recipe made which video
A Sume bulk queue can span a Format edit. Store format.version from each child receipt so you know which recipe made which video.
Written by Sume