---
title: "Force Refresh Agent Pages"
method: POST
path: "/{brand_id}/sites/{site_id}/agent-pages/refresh"
tags: ["agent-pages"]
---

# Force Refresh Agent Pages

`POST /{brand_id}/sites/{site_id}/agent-pages/refresh`

## Request

- Base URL: `https://api.scrunchai.com/v1`
- URL: `https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh`
- Auth: HTTP bearer

Refetch, re-optimize and republish existing Agent Pages now. Returns one outcome per requested path. Each path can be refreshed once every 5 minutes, and each brand up to 500 times per rolling hour and 5,000 per rolling 24 hours. Returns 429 with a `Retry-After` header when the brand's quota is used up, and 409 when Agent Pages are not active on the site.

## Path parameters

- `brand_id` integer, required
- `site_id` union, required
  - string
  - string, binary

## Request body

- AgentPagesRefreshRequest
  - `paths` string[], required: Site-relative paths to refresh, e.g. ['/pricing'].

## Response `202`

Successful Response

- AgentPagesRefreshResponse
  - `results` AgentPagesRefreshResult[], required
    - `path` string, required
    - `outcome` 'queued' | 'not_found' | 'excluded' | 'cooldown' | 'rate_limited', required
    - `retry_after` string, date-time, nullable
  - `quota` AgentPagesRefreshQuotas, required: The brand's rolling windows. A path is queued only while both have room.
    - `hourly` AgentPagesRefreshQuota, required
      - `limit` integer, required
      - `remaining` integer, required
      - `resets_at` string, date-time, nullable
    - `daily` AgentPagesRefreshQuota, required
      - `limit` integer, required
      - `remaining` integer, required
      - `resets_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `1fd00d7a1f83`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scrunchai/apis/scrunch-data-api/changes/:brand_id/sites/:site_id/agent-pages/refresh/post.md)

---

[API](https://skmtc.dev/scrunchai/apis/scrunch-data-api.md) - [All operations](https://skmtc.dev/scrunchai/apis/scrunch-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrunchai/apis/scrunch-data-api/revisions/de4fc679600a?raw)