Delete audience

Delete an audience by ID.

If other audiences are built on this one, the delete is refused with 409 and code has_dependents. The body lists them in dependents. To see the same list without deleting, call GET /api/v1/audiences/{id}/dependents.

Add force=true to delete anyway. Delivr removes the references to this audience from each dependent, rebuilds it, and queues it to refresh. A dependent left with no conditions is paused.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Audience ID.

Query Params
uuid

Project ID (UUID). Every audience operation except GET /api/v1/audiences/schema is scoped to a project: send this parameter or the X-Project-Id header. Without either the request returns 400 with project_id is required.

boolean
Defaults to false

Set to true to delete an audience that has dependents.

Headers
uuid

Project ID (UUID). Equivalent to the project_id query parameter; send one or the other.

Responses
204

Audience deleted.

401

Missing or invalid authentication.

403

Forbidden.

404

Audience not found.

409

Not deleted. Code has_dependents: other audiences are built on this one, and force was not set. Code dependent_not_rebuildable: a dependent already references a persona or company that no longer exists, so force cannot update it. dependent and dependent_id name it. Fix its conditions, then delete again.

503

The audience schema is temporarily unavailable during a forced delete. Retry.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here!