Batches
Create Batch
Uploads a JSONL file and launches a new batch with the provided data. Returns the batch id.
POST
/
v0
/
batches
Authorizations
x-api-key
string
headerrequiredBody
multipart/form-data
batch_input_data
file
requiredthe path to a JSONL file containing objects with the format: { "data_uuid": string, "inputs": array }
task_id
string
requiredtask_version
number
Optional - Version number of the task to be executed. Will default to latest live version.
batch_name
string
Optional - Name for the batch job
webhook_url
string
Optional - Webhook URL to receive results and success status on completion. Data will be sent as a POST request with the data under body.data as an array of objects.
Response
201 - application/json
status
enum<string>
requiredAvailable options:
success
, error
data
object[]
requiredmessage
string
requirederror
object