Start batch call

Schedule a draft batch call so the scheduler starts dialling it.

POSThttps://api.tried.com.au/start-batch-call/{id}

Moves a draft batch to planned so the scheduler picks it up. Create drafts with draft: true on Create batch call. If the batch's scheduled_timestamp is already in the past, it is reset to now. A future time is kept.

Request#

Field	Type	Required	Description
`id`	string	Yes	Path parameter. The `batch_call_id` of a draft batch.

This endpoint takes no body.

Example request#

curl -X POST https://api.tried.com.au/start-batch-call/batch_call_5f2a9c1e7b3d4a6f8e0b1c2d \
  -H "Authorization: Bearer $TRIED_API_KEY"

const id = "batch_call_5f2a9c1e7b3d4a6f8e0b1c2d";
const res = await fetch(`https://api.tried.com.au/start-batch-call/${id}`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const result = await res.json();

import os, requests

batch_id = "batch_call_5f2a9c1e7b3d4a6f8e0b1c2d"
res = requests.post(
    f"https://api.tried.com.au/start-batch-call/{batch_id}",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
result = res.json()

Response#

200 OK

{
  "batch_call_id": "batch_call_5f2a9c1e7b3d4a6f8e0b1c2d",
  "status": "planned"
}

The batch then follows the schedule, call time window and concurrency rules described in Create batch call.

Errors#

Status	When
`400`	`Batch call is <status>, only drafts can be started`.
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request, or the caller has the read-only member role. This route needs the `calls` scope.
`404`	`Batch call <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell's API reference documents only Create batch call. Drafts and this endpoint are Tried additions.