Cancel an Automation run

cURL

curl --request POST 'https://api.brightalk.ai/automation-runs/run_demo_001/cancel' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16" \
  --header "Content-Type: application/json" \
  --data '{}'

const response = await fetch("https://api.brightalk.ai/automation-runs/run_demo_001/cancel", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "POST",
    "https://api.brightalk.ai/automation-runs/run_demo_001/cancel",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    },
    json={},
)
print(response.status_code, response.json())

{
  "id": "run_demo_001",
  "automation_id": "atm_demo_001",
  "contact_id": "con_demo_001",
  "input": {},
  "queued_at": "2026-07-20T01:00:00Z",
  "created_at": "2026-07-20T01:00:00Z",
  "updated_at": "2026-07-20T01:00:00Z",
  "failure_code": "step_failed",
  "started_at": "2026-07-20T01:00:00Z",
  "completed_at": "2026-07-20T01:00:00Z",
  "cancelled_at": "2026-07-20T01:00:00Z"
}

POST

automation-runs

{run_id}

cancel

cURL

curl --request POST 'https://api.brightalk.ai/automation-runs/run_demo_001/cancel' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16" \
  --header "Content-Type: application/json" \
  --data '{}'

const response = await fetch("https://api.brightalk.ai/automation-runs/run_demo_001/cancel", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "POST",
    "https://api.brightalk.ai/automation-runs/run_demo_001/cancel",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    "Content-Type": "application/json",
    },
    json={},
)
print(response.status_code, response.json())

{
  "id": "run_demo_001",
  "automation_id": "atm_demo_001",
  "contact_id": "con_demo_001",
  "input": {},
  "queued_at": "2026-07-20T01:00:00Z",
  "created_at": "2026-07-20T01:00:00Z",
  "updated_at": "2026-07-20T01:00:00Z",
  "failure_code": "step_failed",
  "started_at": "2026-07-20T01:00:00Z",
  "completed_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

Optionally makes this state transition replayable for 24 hours.

Required string length: 1 - 255

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

Path Parameters

run_id

string

required

The opaque Automation run identifier. An opaque resource identifier.

Required string length: 1 - 255

Example:

"run_demo_001"

Body

application/json

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

The body is of type object.

Response

Current Automation run returned.

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"run_demo_001"

status

enum<string>

required

Available options:

queued,

running,

waiting,

completed,

failed,

cancelled

automation_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"atm_demo_001"

contact_id

string

required

An opaque resource identifier.

Required string length: 1 - 255

Example:

"con_demo_001"

input

object

required

Only names declared by the selected Automation may be supplied. Input is limited to 32 KiB of serialized JSON and nesting depth 10. The current contract exposes no declared names, so omit input or send an empty object.

queued_at

string<date-time>

required

When the run entered the durable queue.

Example:

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

created_at

string<date-time>

required

When the run resource was created.

Example:

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

updated_at

string<date-time>

required

When the run resource was last updated.

Example:

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

failure_code

string

A stable failure classification when the run fails.

Example:

"step_failed"

started_at

string<date-time>

When execution began.

Example:

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

completed_at

string<date-time>

When execution completed.

Example:

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

cancelled_at

string<date-time>

When cancellation completed.

Example:

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

Retrieve an Automation run

⌘I

Get started

API fundamentals

Core concepts

Guides

Release information

API Reference

Authorizations

Headers

Path Parameters

Body

Response