Sign in

v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2193427579.9 KB
Batches

Create a new batch for processing multiple API requests.

Create a new batch for processing multiple API requests.

post/v1/batches

Request body

input_file_idstring required

The ID of an uploaded file containing requests for the batch.

endpointstring required

The endpoint to be used for all requests in the batch.

completion_window'24h' required

The time window within which the batch should be processed.

metadataobject nullable

Optional metadata for the batch.

idempotency_keystring nullable

Optional idempotency key. When provided, enables idempotent behavior.

Response

The created batch object.

idstring required
completion_windowstring required
created_atinteger required
endpointstring required
input_file_idstring required
object'batch' required
status'validating' | 'failed' | 'in_progress' | 'finalizing' | 'completed' | 'expired' | 'cancelling' | 'cancelled' required
cancelled_atinteger nullable
cancelling_atinteger nullable
completed_atinteger nullable
error_file_idstring nullable
expired_atinteger nullable
expires_atinteger nullable
failed_atinteger nullable
finalizing_atinteger nullable
in_progress_atinteger nullable
metadataobject nullable
modelstring nullable
output_file_idstring nullable