SCscrunch
agent-pages

Force Refresh

Changed on

Refetch existing Agent Pages from your live site now, then re-optimize and republish them, whether or not they changed. Use it after updating pages on your site so AI agents see the new version without waiting for the next scheduled check.

Only pages that already have an active Agent Page can be refreshed. The endpoint returns one outcome per requested path, and queued refreshes run in the background. A page whose origin now redirects to another path is not republished: the redirect is recorded, and the page retires at the next scheduled check, within about a day.

Limits: 100 paths per request; each path once every 5 minutes; per brand, 500 refreshes per rolling hour and 5,000 per rolling 24 hours.

Force Refresh does not add or remove pages, and does not change curated (Adaptive) content at the same path. To take an Agent Page down, use Agent Pages Unpublish. To add one, use Agent Pages Publish.

post/{brand_id}/sites/{site_id}/agent-pages/refresh

Request

Path parameters

brand_idinteger required

The unique identifier for the brand that owns the site.

site_idstring required

The ULID of the registered site whose Agent Pages you are refreshing.

Request body

pathsstring[] required

Site-relative paths to refresh, e.g. /pricing. 1 to 100 entries, each up to 2,048 characters. Full or protocol-relative URLs are rejected. Paths are trimmed and normalized (lowercased, trailing slash and query string dropped), and duplicates after normalization are merged. / is the homepage.

Response

One outcome per requested path, in request order, plus the brand's remaining quota.

Changes