Get a site's custom VCL
Answers the three snippets a site may add to the platform's VCL, the version every save sends back, the revision Varnish runs and the limits.
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.
Returns
200 The site's custom VCL.
Fields of the 200 answer
Format: date-time.
Who saved it.
The number of the revision Varnish runs.
Whether Varnish is on.
The three snippets: recv runs when a request arrives, backend_response when Magento has answered, deliver before the answer is sent.
Fields
Fields
True while Corefinity manages the site's VCL: saves are refused vcl_locked.
The platform's part of the VCL, which your snippets run inside.
Fields
The path of GET /, with the /api prefix.
The path of GET /, with the /api prefix.
Why Varnish refused the saved revision, when it did.
The automatic return to the revision before a refused one, while it runs or after it failed.
The number of the saved revision.
The path of GET /, with the /api prefix.
Where the saved revision stands, such as applied, saving, pending_verify or saved_dormant.
Send it back with every save.
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 \
-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');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/varnish/vcl', {
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",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"applied_at": "2026-11-02T15:41:09Z",
"applied_by": {
"mcp": false,
"name": "Eleanor Finch"
},
"applied_revision": 1,
"available": true,
"enabled": true,
"hooks": {
"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": "if (req.url ~ \"^/stock-checker/\") {\n return (pass);\n}\n"
},
"limits": {
"per_hook_bytes": 16384,
"statements_per_hook": 200,
"total_bytes": 49152,
"used": {
"backend_response_bytes": 72,
"deliver_bytes": 63,
"recv_bytes": 57,
"total_bytes": 192
}
},
"locked": false,
"platform": {
"content_url": "/api/corestack/sites/1042/varnish/vcl/platform"
},
"policy_url": "/api/corestack/sites/1042/varnish/vcl/policy",
"refusal": null,
"revert": null,
"revision": 1,
"snippets_url": "/api/corestack/sites/1042/varnish/vcl/snippets",
"status": "applied",
"status_reason": null,
"varnish_version": "7.7",
"version": 1
}{
"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
}