CorefinityCorefinityDocs
Open the Control PanelControl Panel
Varnish · 19 of 19

List a site's Varnish versions

Answers the Varnish versions the site's Magento may use, on their own.

GET/api/corestack/sites/{site}/varnish/versions

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.

Returns

200 The versions.

Fields of the 200 answer
default_versionstring or nullRequired
enabledboolean or nullRequired
optionsarray of objectsRequired
Fields of each item
allowedbooleanRequired

Whether the site may move to it. False for the current version, which it already runs.

currentbooleanRequired
reasonstring or nullRequired

Why it is not allowed; for the current version, that it is the current one.

statusstringRequired

Where the version stands, such as lts, eol or prerelease.

versionstringRequired
versionstring or nullRequired

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/versions \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "default_version": "7.7",
  "enabled": true,
  "options": [
    {
      "allowed": true,
      "current": false,
      "reason": null,
      "status": "eol",
      "version": "8.0"
    },
    {
      "allowed": false,
      "current": true,
      "reason": "This is the current version",
      "status": "eol",
      "version": "7.7"
    },
    {
      "allowed": true,
      "current": false,
      "reason": null,
      "status": "lts",
      "version": "6.0"
    }
  ],
  "version": "7.7"
}
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