Skip to main content
PATCH
Rename an audience or change its filter

Authorizations

Authorization
string
header
required

Tenant API key (vdx_live_…) as Authorization: Bearer.

Path Parameters

id
string<uuid>
required

Body

application/json
name
string
description
string
filter
object

A filter tree that compiles to a WHERE clause. Two things make customer-supplied JSON safe there: only whitelisted fields are reachable, and every value is bound — nothing a caller supplied is ever interpolated into statement text.

Attribute rules compile to an EXISTS, not a join: a join multiplies rows the moment two attribute rules appear in one filter, and an audience count has to be a count of people.

Response

Updated.

id
string<uuid>
name
string
description
string | null
filter
object

A filter tree that compiles to a WHERE clause. Two things make customer-supplied JSON safe there: only whitelisted fields are reachable, and every value is bound — nothing a caller supplied is ever interpolated into statement text.

Attribute rules compile to an EXISTS, not a join: a join multiplies rows the moment two attribute rules appear in one filter, and an audience count has to be a count of people.

createdAt
string<date-time>
updatedAt
string<date-time> | null