curl --request POST \
--url https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paths": [
"<string>"
],
"recheck": true
}
'import requests
url = "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh"
payload = {
"paths": ["<string>"],
"recheck": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({paths: ['<string>'], recheck: true})
};
fetch('https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paths' => [
'<string>'
],
'recheck' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh"
payload := strings.NewReader("{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"path": "/pricing",
"outcome": "queued",
"retry_after": null
},
{
"path": "/blog/launch",
"outcome": "cooldown",
"retry_after": "2026-10-07T18:42:10Z"
},
{
"path": "/careers",
"outcome": "not_found",
"retry_after": null
}
],
"quota": {
"hourly": {
"limit": 500,
"remaining": 499,
"resets_at": "2026-10-07T19:02:41Z"
},
"daily": {
"limit": 5000,
"remaining": 4987,
"resets_at": "2026-10-08T09:15:03Z"
}
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Force Refresh
Refetch existing Agent Pages from your site and re-optimize them now. If the result differs from what agents are served, it is published within minutes; if not, agents keep seeing the same page. Use it after updating your site so AI agents get the new version without waiting for the next scheduled check.
Force Refresh only works on paths that already have an Agent Page; any other path returns not_found. To add a page, including one that isn’t in your sitemap, use Agent Pages Publish.
The response has one outcome per requested path; the refresh itself runs in the background. Your origin or CDN may keep serving the old page for a while after an update, so Scrunch checks each queued page again a few times over the next hours and publishes it at the next check after the new version appears. recheck_checks in each result says how many checks were scheduled. These follow-up checks don’t use quota. Send recheck: false to refresh once only.
A page whose origin now redirects to another path is not republished: the redirect is recorded, and the page retires at a later scheduled check, usually within a day. A site with many redirects at once can take several days, because removals per site per day are capped.
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. 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.
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.
curl --request POST \
--url https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paths": [
"<string>"
],
"recheck": true
}
'import requests
url = "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh"
payload = {
"paths": ["<string>"],
"recheck": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({paths: ['<string>'], recheck: true})
};
fetch('https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paths' => [
'<string>'
],
'recheck' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh"
payload := strings.NewReader("{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scrunchai.com/v1/{brand_id}/sites/{site_id}/agent-pages/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"paths\": [\n \"<string>\"\n ],\n \"recheck\": true\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"path": "/pricing",
"outcome": "queued",
"retry_after": null
},
{
"path": "/blog/launch",
"outcome": "cooldown",
"retry_after": "2026-10-07T18:42:10Z"
},
{
"path": "/careers",
"outcome": "not_found",
"retry_after": null
}
],
"quota": {
"hourly": {
"limit": 500,
"remaining": 499,
"resets_at": "2026-10-07T19:02:41Z"
},
"daily": {
"limit": 5000,
"remaining": 4987,
"resets_at": "2026-10-08T09:15:03Z"
}
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
Body
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.
1 - 100 elementsYour origin or CDN may keep serving the old page for a while after an update, so each queued page is checked again a few times over the next hours and published at the next check after the new version appears. How many checks a page gets is in its result's recheck_checks. These checks don't use quota. Send false to refresh once only.
Response
One outcome per requested path, in request order, plus the brand's remaining quota.