List a site's VCL revisions
Lists the revisions of the site's custom VCL, newest first, 20 a page; revision 0 is the empty snippets the site started with. Paged by cursor: send next_cursor back as cursor; null means the last page.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Query parameters
The next_cursor of the previous answer. Send only a cursor the list gave you; the list's own page says what any other value answers.
Returns
200 A page of revisions.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
Whether Varnish runs it.
The person's name, or Corefinity. Left out when the account no longer exists.
Format: date-time.
Whether it is the saved VCL.
Fields
The snippets it changed.
recvbackend_responsedeliverAt least 1.
Whether an AI assistant made it.
How the revision came about, such as save, revert or platform for revision 0.
Where the revision stands, such as saving, pending_verify, applied, rejected, verify_failed, rolled_back, superseded or saved_dormant.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | varnish_not_offered | Varnish is available for Magento 2 sites only. Nothing to change here. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl/revisions \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl/revisions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl/revisions', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl/revisions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"next_cursor": null,
"revisions": [
{
"applied": true,
"author": "Eleanor Finch",
"created_at": "2026-11-02T15:41:09Z",
"current": true,
"diagnostics": {
"errors": 0,
"warnings": 0
},
"hooks": [
"recv"
],
"id": 41,
"mcp": false,
"note": "Never cache the stock checker",
"number": 1,
"operation_id": 5120,
"origin": "save",
"status": "applied"
},
{
"applied": false,
"author": "Corefinity",
"created_at": "2026-11-01T10:02:11Z",
"current": false,
"diagnostics": {
"errors": 0,
"warnings": 0
},
"hooks": [
"recv",
"backend_response",
"deliver"
],
"id": 40,
"mcp": false,
"number": 0,
"operation_id": null,
"origin": "platform",
"status": "applied"
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "varnish_not_offered",
"message": "Varnish is available for Magento 2 sites only.",
"reason": "varnish_not_offered"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}