Skip to main content
POST
/
batch-call
/
{id}
/
execute
curl -X POST "https://api.zudu.ai/batch-call/batch_abc123/execute" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch call execution started",
  "status": "success",
  "data": {
    "batch_call_id": "batch_abc123",
    "status": "SENT",
    "execution_started_at": "2024-01-15T11:00:00Z"
  }
Manually execute a batch call that is in DRAFT or SCHEDULED status. Execution happens asynchronously. 
curl -X POST "https://api.zudu.ai/batch-call/batch_abc123/execute" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch call execution started",
  "status": "success",
  "data": {
    "batch_call_id": "batch_abc123",
    "status": "SENT",
    "execution_started_at": "2024-01-15T11:00:00Z"
  }

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Path Parameters

​
id
string
required
The batch call ID to execute (format: batch_...)

​
Response Fields

​
batch_call_id
string
The batch call ID
​
status
string
Updated status (changes to SENT when execution starts)
​
execution_started_at
string
ISO 8601 timestamp when execution started

​
Error Responses

​
error
string
Bad Request - Batch call cannot be executed
{
  "message": "Validation error",
  "status": "error",
  "error": "Cannot execute batch call with status COMPLETED"
}
​
error
string
Not Found - Batch call does not exist

​
Notes

  • Only DRAFT and SCHEDULED batch calls can be executed manually
  • Execution is asynchronous - calls are queued and processed in the background
  • Status changes to SENT when execution starts
  • Check task status via the tasks endpoint to monitor progress