Skip to main content
POST
Resume a cancelled batch
Re-enqueues pending and failed documents. Completed rows stay untouched. Billed at the batch page rate for work that actually runs.

Authorizations

Authorization
string
header
required

Extract API key (sk-abacus-*)

Path Parameters

batch_id
integer
required

Response

Response shape for POST /api/v2/batches/{batch_id}/resume/ (AD-419).

Resumes a cancelled batch by flipping CANCELLED docs back to PENDING and re-enqueueing process_batch. COMPLETED and FAILED docs are untouched.

Fields: batch: The updated parent batch (status flipped to PROCESSING). resumed_doc_count: Number of CANCELLED BatchDocument rows flipped back to PENDING. estimated_credit_cost: Best-effort millicredit estimate for the remaining cancelled docs (informational; actual deduction happens inside process_batch).

batch
object
required

Compact projection of a Batch row for responses that need to echo the parent batch state alongside per-row payloads.

Currently used by BatchReprocessResponse so the SPA can update its batch header (status pill, default version chip) without a follow-up GET.

resumed_doc_count
integer
required
estimated_credit_cost
integer
required

Estimated millicredit cost across resumed cancelled docs (page_count * the organisation's batch page rate). Informational.