Update Audience

patchhttps://db.fullvision.io/v1/audiences/{id}

Returns the updated audience.

Use it when the definition needs to change. Replacing the rule tree invalidates the current snapshot, so any attached destination sees a full re-upload on its next sync.

Partial update of an audience. Setting criteria triggers an immediate refresh; setting refresh_interval_sec adjusts cadence on the next scheduler tick.

Authorization

AuthorizationBearer <token>

API key as Bearer token

In: header

Path Parameters

id*string

Formatuuid

Request Body

application/json

Partial update. Setting criteria_json triggers an immediate refresh. Fields outside this schema are ignored; a body with no recognized field returns no_changes.

name?string

Length1 <= length <= 128

criteria_json?

Top-level audience criteria. The compiler walks root and emits one CH SELECT DISTINCT person_id query.

refresh_interval_sec?integer

Range0 <= value

Responses

Updated. Returns the id only — fetch GET /v1/audiences/{id} for the full record.

id*string

Formatuuid

patch/v1/audiences/{id}

curl -X PATCH "https://db.fullvision.io/v1/audiences/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'

Example Request Body

json

{}

Example Responses

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}

application/json