Stocking stuffer ads for 100 products: one bulk run, 16 at a time

Sume's bulk-run endpoint takes 1 to 100 items per queue and a concurrency of 1 to 16. For a 100-item stocking stuffer catalog, submit one queue, set concurrency to something your plan can actually run, and poll the queue until it ends. Then read counts.failed, because a completed queue is not the same as a successful one.

Set up the run

Pick a Format from the catalog at the sume handle, supply one item per product, and send a fresh Idempotency-Key for each batch so a retry cannot double-submit.

POST /v1/formats/sume/<slug>/bulk-runs
Idempotency-Key: stuffers-batch-01

# 1-100 items, concurrency 1-16
# then: GET /v1/format-run-queues/{id}

Pick a sane concurrency

Concurrency is yours to set, but admission is your plan's: a Pro account runs 4 generation jobs at once and can hold 20 queued, so asking for 16 workers does not make a Pro account faster.

Poll, do not wait for a webhook

Bulk queues have no queue webhook, so poll GET /v1/format-run-queues/{id} on an interval. Individual jobs can still use webhooks if you need them.

After the queue ends

Read counts.failed. Resubmit only the failed items in a new batch with a new Idempotency-Key, and keep the first batch's key unchanged so the original stays safe to retry.