Skip to main content
POST
/
api
/
v1
/
calls
Schedule a new voice call with an AI agent
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    endpoint: '<string>',
    additionalData: {},
    priority: 1,
    callDeadline: null,
    timezone: null
  })
};

fetch('https://blackbox.dasha.ai/api/v1/calls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "endpoint": "<string>",
  "callId": "<string>",
  "orgId": "<string>",
  "agentId": "<string>",
  "createdTime": "2023-11-07T05:31:56Z",
  "status": "Unknown",
  "nextScheduleTime": "2023-11-07T05:31:56Z",
  "additionalData": {},
  "priority": 123,
  "callDeadline": "2023-11-07T05:31:56Z",
  "timezone": "<string>"
}

Query Parameters

​
agentId
string

Target agent ID for call execution

Body

Complete call configuration and scheduling details

​
endpoint
string
required
Minimum string length: 1
​
additionalData
object
​
priority
integer<int32> | null
default:1
​
callDeadline
string<date-time> | null
​
timezone
string | null

Response

Call scheduled successfully

​
endpoint
string
required
Minimum string length: 1
​
callId
string
required
Minimum string length: 1
​
orgId
string
required
Minimum string length: 1
​
agentId
string
required
Minimum string length: 1
​
createdTime
string<date-time>
required
​
status
enum<string>
required
Available options:
Unknown,
Created,
Pending,
Queued,
Completed,
Failed,
Canceled,
Running
​
nextScheduleTime
string<date-time>
required
​
additionalData
object
​
priority
integer<int32> | null
​
callDeadline
string<date-time> | null
​
timezone
string | null