Create a batch
Creates a batch from an uploaded input file. The batch starts in
validating. Send an Idempotency-Key header to make retries safe: a
repeat with the same key returns the original batch.
output_expires_after is not supported and is rejected with a 400;
output and error files are kept 30 days.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unique key for this create; a repeat returns the original batch
200Body
Id of a file uploaded with purpose=batch
Endpoint every line in the input file targets
/v1/responses Target completion time; 24h is the only value and the default
24h Up to 16 key value pairs; keys up to 64 characters, values up to 512
Response
The created batch
batch validating, in_progress, finalizing, completed, expired, cancelling, cancelled, failed Unix seconds