Create audience with version

Create a new audience in the page and trigger version creation/publishing

POST /v0/pages/{page_id}/audiences

Create audience with version

cURL

curl --request POST \
  --url https://api.tryarchitect.com/v0/pages/{page_id}/audiences \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "supplementaryContext": "<string>",
  "customName": "<string>"
}
'

201

{
  "audienceId": "<string>",
  "pageId": "<string>",
  "tenantId": "<string>",
  "createdAt": "<string>",
  "status": "<string>"
}

Authorizations

x-api-key · string · header · required

API key authentication for the External Actor Gateway

Path Parameters

page_id · string · required

page_id parameter

Body

application/json

supplementaryContext · string

customName · string

Response

201 - application/json

Audience created successfully

audienceId · string · required

The created audience ID

pageId · string · required

The parent page ID

tenantId · string · required

The tenant ID

createdAt · string · required

ISO 8601 creation timestamp

status · string · required

Audience version creation status (always 'processing' on create)

Allowed value: "processing"