v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Bucket Batches

Resubmit Failed Batch

Re-run a terminal (FAILED/CANCELED/COMPLETED/…) batch: resets it to DRAFT and auto-submits by default, so the verb matches the behavior. Pass auto_submit=false to only park it as DRAFT — it must then be submitted manually before the draft TTL expires.

post/v1/buckets/{bucket_identifier}/batches/{batch_id}/resubmit

Path parameters

bucket_identifierstring required

The unique identifier of the bucket.

The unique identifier of the bucket.

batch_idstring required

The unique identifier of the batch.

The unique identifier of the batch.

Query parameters

from_tierinteger nullable

Resubmit starting from this tier number (0-indexed). Tiers before from_tier are preserved as COMPLETED. Omit to resubmit all tiers from scratch.

Resubmit starting from this tier number (0-indexed). Tiers before from_tier are preserved as COMPLETED. Omit to resubmit all tiers from scratch.

auto_submitboolean nullable

Auto-submit after the DRAFT reset. DEFAULT TRUE — 'resubmit' means re-run the batch, so one call does both. Pass false to only reset to DRAFT (parked; you must POST /submit before the draft TTL expires or the zombie reaper cancels it). Accepted here (query) or in the JSON body as {"auto_submit": false}.

Auto-submit after the DRAFT reset. DEFAULT TRUE — 'resubmit' means re-run the batch, so one call does both. Pass false to only reset to DRAFT (parked; you must POST /submit before the draft TTL expires or the zombie reaper cancels it). Accepted here (query) or in the JSON body as {"auto_submit": false}.

trigger_processingboolean nullable

Deprecated alias of auto_submit (kept for callers taught by the old submit-endpoint 400 hint). Accepted in query or JSON body; auto_submit wins when both are supplied.

Deprecated alias of auto_submit (kept for callers taught by the old submit-endpoint 400 hint). Accepted in query or JSON body; auto_submit wins when both are supplied.

Request body

object nullable required

Optional body; {"auto_submit": bool} (or the deprecated {"trigger_processing": bool}) is honored.

Response

Successful Response

object required