Refresh audience

Reset the audience to the Pending state so the renewal worker re-runs its unload. Use this to manually trigger a fresh build when you don't want to wait for the next scheduled renew_time tick, or to recover an audience that hit a transient Failed state.

Refresh does not re-validate or re-compile the filter, so it succeeds even when the upstream schema service is unavailable. It also does not change the filter, name, description, or any other configuration. The response is the audience as-of the reset, with status = Pending and task_id cleared.

Returns 409 Conflict when the audience is already mid-unload (Syncing). Returns 400 for audience types that don't run through the background worker (e.g. events).

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

Audience ID.

Responses

401

Missing or invalid authentication.

403

Forbidden.

404

Audience not found.

500

Internal server error.

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