Get one VCL revision
Answers one revision with its three snippets and a unified diff of each against the VCL now, or against another revision.
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.
A revision's number, from the list. The first is 0.
Query parameters
The number of the revision to compare with, or current (the default).
Returns
200 The revision and its differences.
Fields of the 200 answer
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.
The number of the revision it is compared with. Null when the site has no revision with the number asked for; the diff is then against nothing.
The three snippets: recv runs when a request arrives, backend_response when Magento has answered, deliver before the answer is sent.
Fields
Fields of each item
The policy's rule, such as VN-POL-09; the policy explains each. Left out of a finding of the compiler, which has no rule.
The snippet it is about (recv, backend_response or deliver), or * for the policy's limit on the snippets together. Empty for a finding of the compiler about the VCL as a whole, whose line and column are 0.
What found it: the policy (policy for an error, advice for a warning) or the compiler (compile).
policycompileadviceerrorwarningWhat found it, in words, such as the Varnish version the compile ran on. Left out of a finding of the policy.
A unified diff per snippet. Null where it agrees.
Fields
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. |
422 | invalid | Fix the field named in field; errors says why. |
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/0 \
-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/0');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl/revisions/0', {
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/0",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"against": 1,
"applied": false,
"author": "Corefinity",
"content": {
"backend_response": "# Your vcl_backend_response snippet. Empty means the platform VCL only.\n",
"deliver": "# Your vcl_deliver snippet. Empty means the platform VCL only.\n",
"recv": "# Your vcl_recv snippet. Empty means the platform VCL only.\n"
},
"content_sha256": "3b4323671f111e8235c1f2dec5c8b2757c2ceddb81a234dda5df7b02c7306bfa",
"created_at": "2026-11-01T10:02:11Z",
"current": false,
"diagnostics": {
"errors": 0,
"warnings": 0
},
"diagnostics_list": [],
"diff": {
"backend_response": null,
"deliver": null,
"recv": "--- revision 1\n+++ revision 0\n@@ -1,3 +1,1 @@\n-if (req.url ~ \"^/stock-checker/\") {\n- return (pass);\n-}\n+# Your vcl_recv snippet. Empty means the platform VCL only.\n"
},
"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": "invalid",
"errors": {
"against": [
"against is current or a revision number."
]
},
"field": "against",
"message": "against is current or a revision number.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}