CorefinityCorefinityDocs
Open the Control PanelControl Panel
Varnish · 13 of 19

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.

GET/api/corestack/sites/{site}/varnish/vcl/revisions

Path parameters

siteintegerRequired

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

cursorstring

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
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

revisionsarray of objectsRequired
Fields of each item
appliedbooleanRequired

Whether Varnish runs it.

authorstring or null

The person's name, or Corefinity. Left out when the account no longer exists.

created_atstring or nullRequired

Format: date-time.

currentbooleanRequired

Whether it is the saved VCL.

diagnosticsobject
Fields
errorsinteger
warningsinteger
hooksarray of stringsRequired

The snippets it changed.

recvbackend_responsedeliver
idintegerRequired

At least 1.

mcpboolean

Whether an AI assistant made it.

notestring or null
numberintegerRequired
operation_idinteger or null
originstringRequired

How the revision came about, such as save, revert or platform for revision 0.

statusstringRequired

Where the revision stands, such as saving, pending_verify, applied, rejected, verify_failed, rolled_back, superseded or saved_dormant.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409varnish_not_offeredVarnish is available for Magento 2 sites only. Nothing to change here.
429rate_limitedWait 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"
{
  "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"
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT