Bulk item says 'The Format run failed.' Read the run receipt

When a child of a Sume bulk queue fails, the queue item shows error.code of format_run_failed and the message The Format run failed. That text is the same for every failure, so it cannot tell you why. To find the reason, read the child's run receipt at GET /v1/format-runs/{run_id} using the run_id on that item.

The error table is in Bulk runs (read 2026-10-06). During a Cyber Monday batch, this is the step between a red counts.failed and a fix you can act on.

What does each item state tell me?

The item error is set only when the item did not finish well, and its value depends on how the child ended.

What is the order of work?

Poll the queue, collect the failed indexes, then read one receipt per failed run_id.

• counts.failed above zero means at least one item failed, even when the queue status is completed.
• An item with run_id: null has no receipt, so read its error on the queue object instead.
• The queue never stops on a failure, so the other items keep running while you read the receipt.

curl -sS "https://api.sume.com/v1/format-run-queues/$QUEUE_ID" \
  -H "Authorization: Bearer $SUME_API_KEY"

# For each item with status "failed" and a run_id:
curl -sS "https://api.sume.com/v1/format-runs/$RUN_ID" \
  -H "Authorization: Bearer $SUME_API_KEY"

Should I retry the whole queue?

No. Fix the cause the receipt names, then send only the failed rows in a new queue with a new idempotency key. Replaying the old key returns the old queue and starts nothing.