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.
