Pause audience

Pause an audience so it stops auto-renewing on its scheduled renew_time. The current schedule is stashed in previous_renew_time and restored on resume; paused_at is stamped and pause_reason is set to manual.

Pausing does not cancel an in-flight unload, clear results, or change the filter. A paused audience can still be downloaded. It cannot be refreshed until it is resumed: the renewal worker skips paused rows, so a queued rebuild would never be claimed, and refresh returns 409 with pause_reason rather than accepting work that cannot run.

Returns 409 Conflict when the audience is already 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.

Headers
uuid

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

Responses

400

Invalid audience ID.

401

Missing or invalid authentication.

403

Forbidden.

404

Audience not found.

500

Internal server error.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json