Skip to main content
POST
/
v1
/
intent
/
audiences
/
{id}
/
runs
Queue an intent audience materialization run
curl --request POST \
  --url https://api.aws53.cloud/v1/intent/audiences/{id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "runType": "manual"
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "audienceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "configHash": "<string>",
    "dataDate": "2023-12-25",
    "resultKey": "<string>",
    "candidateCount": 123,
    "resultCount": 123,
    "attempts": 123,
    "nextAttemptAt": "2023-11-07T05:31:56Z",
    "idempotencyKey": "<string>",
    "errorCode": "<string>",
    "errorMessage": "<string>",
    "startedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z",
    "cancelledAt": "2023-11-07T05:31:56Z",
    "readyEmailSentAt": "2023-11-07T05:31:56Z",
    "readyEmailExportId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "readyEmailError": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "request_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Dashboard access token. Send as Authorization: Bearer .

Headers

​
Idempotency-Key
string

Optional client idempotency key. Reusing the same key returns the same run.

Maximum string length: 120

Path Parameters

​
id
string<uuid>
required

Body

application/json
​
runType
enum<string>
default:manual

Public run creation only supports manual runs. Daily runs are queued by the worker scheduler.

Available options:
manual
Example:

"manual"

Response

Run queued or existing in-flight run returned

​
data
object
required
​
meta
object
required