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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Missing or invalid authentication.
403Forbidden.
404Audience not found.
500Internal server error.
