Queue one immediate AI call

cURL

curl --request POST 'https://api.brightalk.ai/calls' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: createCall-example-001" \
  --data '{"agent_id":"agt_demo_001","contact_id":"con_demo_001"}'

const response = await fetch("https://api.brightalk.ai/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    "Idempotency-Key": "createCall-example-001",
  },
  body: JSON.stringify({"agent_id":"agt_demo_001","contact_id":"con_demo_001"}),
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "POST",
    "https://api.brightalk.ai/calls",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    "Idempotency-Key": "createCall-example-001",
    },
    json={"agent_id":"agt_demo_001","contact_id":"con_demo_001"},
)
print(response.status_code, response.json())

{
  "id": "call_demo_001",
  "contact_id": "con_demo_001",
  "agent_id": "agt_demo_001",
  "queued_at": "2026-07-20T01:00:00Z",
  "created_at": "2026-07-20T01:00:00Z",
  "updated_at": "2026-07-20T01:00:00Z",
  "batch_id": "bat_demo_001",
  "automation_run_id": "run_demo_001",
  "outcome": "qualified",
  "outcome_reason": "Requested a follow-up.",
  "summary": "Customer requested a follow-up next week.",
  "duration_seconds": 92,
  "dialing_at": "2026-07-20T01:00:00Z",
  "connected_at": "2026-07-20T01:00:00Z",
  "ended_at": "2026-07-20T01:00:00Z",
  "cancel_requested_at": "2026-07-20T01:00:00Z",
  "cancelled_at": "2026-07-20T01:00:00Z"
}

POST

calls

cURL

curl --request POST 'https://api.brightalk.ai/calls' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: createCall-example-001" \
  --data '{"agent_id":"agt_demo_001","contact_id":"con_demo_001"}'

const response = await fetch("https://api.brightalk.ai/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    "Idempotency-Key": "createCall-example-001",
  },
  body: JSON.stringify({"agent_id":"agt_demo_001","contact_id":"con_demo_001"}),
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "POST",
    "https://api.brightalk.ai/calls",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    "Idempotency-Key": "createCall-example-001",
    },
    json={"agent_id":"agt_demo_001","contact_id":"con_demo_001"},
)
print(response.status_code, response.json())

{
  "id": "call_demo_001",
  "contact_id": "con_demo_001",
  "agent_id": "agt_demo_001",
  "queued_at": "2026-07-20T01:00:00Z",
  "created_at": "2026-07-20T01:00:00Z",
  "updated_at": "2026-07-20T01:00:00Z",
  "batch_id": "bat_demo_001",
  "automation_run_id": "run_demo_001",
  "outcome": "qualified",
  "outcome_reason": "Requested a follow-up.",
  "summary": "Customer requested a follow-up next week.",
  "duration_seconds": 92,
  "dialing_at": "2026-07-20T01:00:00Z",
  "connected_at": "2026-07-20T01:00:00Z",
  "ended_at": "2026-07-20T01:00:00Z",
  "cancel_requested_at": "2026-07-20T01:00:00Z",
  "cancelled_at": "2026-07-20T01:00:00Z"
}

Authorizations

Authorization

string

header

required

Use a private-beta server credential in the Authorization header.

Headers

Brightalk-Version

string

default:2026-07-16

Selects the date-based API version. Omission uses the organization’s pinned private-beta default.

Allowed value: "2026-07-16"

X-Request-Id

string

A caller-generated correlation value matching [A-Za-z0-9._:-]{1,64}. Invalid values are replaced.

Maximum string length: 64

Pattern: ^[A-Za-z0-9._:-]{1,64}$

Idempotency-Key

string

required

A nonsecret key retained for 24 hours. Reuse only for a semantically identical request.

Required string length: 1 - 255

Pattern: ^(?=.{1,255}$)[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$

Body

application/json

JSON request body. The raw encoded body is limited to 1 MiB and unknown fields are rejected.

Option 1
Option 2

agent_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"agt_demo_001"

contact_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"con_demo_001"

Response

Call accepted into the durable queue.

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"call_demo_001"

status

enum<string>

required

Available options:

queued,

dialing,

in_progress,

completed,

failed,

cancelled

answer_status

enum<string>

required

Available options:

answered,

no_answer,

busy,

voicemail,

unknown

contact_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"con_demo_001"

agent_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"agt_demo_001"

queued_at

string<date-time>

required

When the call entered the durable queue.

Example:

"2026-07-20T01:00:00Z"

created_at

string<date-time>

required

When the public Call resource was created.

Example:

"2026-07-20T01:00:00Z"

updated_at

string<date-time>

required

When the Call resource was last updated.

Example:

"2026-07-20T01:00:00Z"

batch_id

string

An opaque resource identifier.

Required string length: 1 - 255

Example:

"bat_demo_001"

automation_run_id

string

An opaque resource identifier.

Required string length: 1 - 255

Example:

"run_demo_001"

outcome

string

A normalized or configured business outcome.

Example:

"qualified"

outcome_reason

string

A concise reason for the outcome.

Example:

"Requested a follow-up."

summary

string

A concise call summary.

Example:

"Customer requested a follow-up next week."

duration_seconds

integer

Required range: x >= 0

Example:

92

dialing_at

string<date-time>

When dialing began.

Example:

"2026-07-20T01:00:00Z"

connected_at

string<date-time>

When the call connected.

Example:

"2026-07-20T01:00:00Z"

ended_at

string<date-time>

When the call ended.

Example:

"2026-07-20T01:00:00Z"

cancel_requested_at

string<date-time>

When cancellation was requested.

Example:

"2026-07-20T01:00:00Z"

cancelled_at

string<date-time>

When cancellation won the terminal-state race.

Example:

"2026-07-20T01:00:00Z"

List API-visible calls Retrieve a call

⌘I

Get started

API fundamentals

Core concepts

Guides

Release information

API Reference

Authorizations

Headers

Body

Response