Create batch

Create an asynchronous batch job from a previously uploaded JSONL input file (purpose=batch). Token360 validates the file, ensures a single body.model across all lines, pins one provider route, and queues upstream submission.

MVP supports only endpoint=/v1/chat/completions and completion_window=24h.

See Batch Jobs for JSONL format and constraints.

Authentication

Authorization Bearer

Request Body

input_file_idstringrequired

File ID from POST /v1/files with purpose=batch.

endpointstring

Must be /v1/chat/completions (default if omitted).

completion_windowstring

Must be 24h (default if omitted).

callback_urlstring

Optional HTTPS URL for terminal-state webhook. Overrides account default batch webhook when set.

metadataobject

Optional key/value metadata stored on the batch object.

Response

idstring

Batch ID (batch_ prefix).

objectstring

batch

endpointstring

/v1/chat/completions

statusstring

validating, then in_progress, etc.

input_file_idstring

Input file ID.

output_file_idstring

Set when completed.

error_file_idstring

Set when partial failures or errors are written.

completion_windowstring

24h

request_countsobject

total, completed, failed counts when available.

request_counts.totalinteger

Total number of requests in the batch.

request_counts.completedinteger

Number of completed requests.

request_counts.failedinteger

Number of failed requests.

created_atinteger

Unix timestamp.

expires_atinteger

Unix timestamp (created + 24h).

metadataobject

Echo of request metadata.

Common errors


`batch_multiple_models`	More than one distinct `body.model` in the input file.
`batch_invalid_jsonl`	Malformed line or invalid fields.
`batch_model_not_supported`	Model has no batch-capable provider route.
`batch_routing_unavailable`	No active SKU for the model.