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), or when it is paused for any reason other than idle.
An idle pause is lifted automatically and refreshes normally; every
other pause, including a manual one, must be resumed first, because
the renewal worker skips paused rows and the queued rebuild would
never be claimed. That response adds pause_reason naming which case
it was.

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
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json