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

Organisation API key from Settings → API / /api/keys/. The secret is shown once. Send Authorization: Bearer sk-abacus-…. One active key per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that surface is Auth0-only with ingest:read / ingest:write scopes.

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 * EXTRACT_MILLICREDITS_PER_PAGE). Informational.