curl --request GET 'https://api.brightalk.ai/automation-runs/run_demo_001' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/automation-runs/run_demo_001", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/automation-runs/run_demo_001",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"id": "run_demo_001",
"status": "queued",
"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"
}Retrieve an Automation run
Returns one API-started Automation run by opaque identifier. Every response includes Brightalk-Version and X-Request-Id; rate-limited responses also expose the effective bucket counters.
curl --request GET 'https://api.brightalk.ai/automation-runs/run_demo_001' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/automation-runs/run_demo_001", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/automation-runs/run_demo_001",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"id": "run_demo_001",
"status": "queued",
"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
Use a server-side Brightalk API key in the Authorization header.
Headers
Selects the date-based API version. Omission uses the organization’s pinned default.
"2026-07-16"A caller-generated correlation value matching [A-Za-z0-9._:-]{1,64}. Invalid values are replaced.
64^[A-Za-z0-9._:-]{1,64}$Path Parameters
The opaque Automation run identifier. An opaque resource identifier.
1 - 255"run_demo_001"
Response
Automation run returned.
An opaque resource identifier.
1 - 255"run_demo_001"
queued, running, waiting, completed, failed, cancelled An opaque resource identifier.
1 - 255"atm_demo_001"
An opaque resource identifier.
1 - 255"con_demo_001"
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.
When the run entered the durable queue.
"2026-07-20T01:00:00Z"
When the run resource was created.
"2026-07-20T01:00:00Z"
When the run resource was last updated.
"2026-07-20T01:00:00Z"
A stable failure classification when the run fails.
"step_failed"
When execution began.
"2026-07-20T01:00:00Z"
When execution completed.
"2026-07-20T01:00:00Z"
When cancellation completed.
"2026-07-20T01:00:00Z"