Skip to main content
POST
/
batch
/
{id}
/
start
Start Batch
curl --request POST \
  --url https://api.tornadoapi.io/batch/{id}/start \
  --header 'x-api-key: <x-api-key>'
{
  "error": "Batch is not paused (current status: processing)"
}

​
Overview

Starts a paused batch, enqueuing all episode jobs for processing. The batch must be in paused status.

​
Header Parameters

​
x-api-key
string
required
Your API key for authentication

​
Path Parameters

​
id
string
required
The batch UUID returned from POST /jobs

​
Response

​
batch_id
string
The batch UUID
​
started_jobs
integer
Number of jobs successfully enqueued for processing
​
status
string
New batch status (processing)

​
Example

curl -X POST "https://api.tornadoapi.io/batch/550e8400-e29b-41d4-a716-446655440001/start" \
  -H "x-api-key: sk_your_api_key"

​
Error Responses

{
  "error": "Batch is not paused (current status: processing)"
}

​
Workflow

The typical paused batch workflow is:
  1. POST /jobs with paused: true - Create batch, get episode titles
  2. PATCH /batch/{id}/jobs - Rename episodes as needed
  3. POST /batch/{id}/start - Start downloading
  4. GET /batch/{id} - Poll for progress