warm_site
Warm (pre-cache) a list of same-origin URLs for one of your sites. Creates a warm run and returns its run_id. The run is asynchronous and takes seconds to minutes depending on the URL count, so follow it with list_warm_runs or get_run instead of assuming it finished. A site runs one warm at a time. Requires the boosts:write scope.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site_id": "<site_id>",
"urls": "<urls>"
},
"name": "warm_site"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | Same-origin URLs to warm. All must be on the site domain (or a subdomain). | |
| region | No | Optional list of regions to warm from (defaults to ["fr"]). | |
| site_id | Yes | ID of the site to warm (must belong to the API key). | |
| variations | No | Optional request variations (e.g. device/header variants). | |
| validation_ratio | No | Optional: percentage of the warmed calls re-checked afterwards to verify the cache (min 5 per region). Defaults to 0 (no check). Each check is billed as a call. |