Skip to main content
POST
Dial the next block

Authorizations

Authorization
string
header
required

Tenant API key (vdx_live_…) as Authorization: Bearer.

Path Parameters

id
string<uuid>
required

Response

The next block was cleared to dial.

id
string<uuid>
name
string
status
enum<string>
Available options:
running,
paused,
completed,
cancelled,
failed
runNo
integer
assistantId
string<uuid>

The assistant's uuid, shown on its configure page in the console. Names and slugs are not accepted.

concurrency
integer
retry
object
window
object | null

When this batch may dial — outside it, rows wait rather than fail.

suppress
string[]
blockSize
integer | null

Rows per block, or null to dial the whole list at once. Set at create.

activeBlock
integer

The highest block cleared to dial (1-based); only meaningful with a blockSize.

createdAt
string<date-time> | null
startedAt
string<date-time> | null
completedAt
string<date-time> | null
counts
object

Row counts by status, plus total.

blocks
object[]