CorefinityCorefinityDocs
Open the Control PanelControl Panel
Deployment templates · 10 of 15

List a deployment template's versions

Answers the template's kept revisions, newest first, 50 a page: who saved each, which stages it changed and how many environments it was written to. Paged by cursor: send next_cursor back as cursor; null means the last page.

GET/api/corestack/companies/{company}/deploy-templates/{platform}/versions

Path parameters

companyintegerRequired

The id of a company you belong to or manage. Digits only. At least 1.

platformstringRequired

The platform the template is for, such as magento2, laravel or wordpress. The list answers the ones your company can have.

Query parameters

cursorinteger

The next_cursor of the previous answer, a whole number here. Anything else is refused 422 invalid on cursor. 0 to 999999.

configstring

With stage, only the versions that changed that stage of this configuration.

productionuat
stagestring

With config.

builddatabasepost_deploysettings
levelstring

corefinity answers the versions of Corefinity's default instead. Not with config and stage.

corefinity

Returns

200 A page of versions.

Fields of the 200 answer
next_cursorinteger or nullRequired
template_idinteger or nullRequired
versionsarray of objectsRequired
Fields of each item
applied_atstring or null

With level corefinity, when that version came into use, in UTC. Format: date-time.

atstring
bystring or null

The name of the person who saved it.

changedarray of objectsRequired

The stages this version changed.

Fields of each item
configstring
stagestring
reachobject or null

How many environments the version was written to.

restored_frominteger or null

The revision this one restored, when it is a restore.

revisioninteger
setsarray of objects

The stages the template set after this version.

Fields of each item
configstring
stagestring
sourcestring

Who made the version, such as person.

versioninteger

With level corefinity, the number of Corefinity's version. At least 1.

version_refobject
Fields
corefinity_versioninteger
revisioninteger
template_idinteger or null

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.
422invalidFix the field named in field; errors says why.
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/companies/1204/deploy-templates/magento2/versions \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "next_cursor": null,
  "template_id": 12,
  "versions": [
    {
      "at": "2026-11-09T10:42:07Z",
      "by": "Maya Okafor",
      "changed": [
        {
          "config": "production",
          "stage": "post_deploy"
        }
      ],
      "reach": {
        "kept": 0,
        "production": 1,
        "uat": 0,
        "written": 1
      },
      "restored_from": null,
      "revision": 2,
      "sets": [
        {
          "config": "production",
          "stage": "post_deploy"
        }
      ],
      "source": "person",
      "version_ref": {
        "revision": 2,
        "template_id": 12
      }
    },
    {
      "at": "2026-11-02T09:15:30Z",
      "by": "Maya Okafor",
      "changed": [
        {
          "config": "production",
          "stage": "post_deploy"
        }
      ],
      "reach": {
        "kept": 0,
        "production": 1,
        "uat": 0,
        "written": 1
      },
      "restored_from": null,
      "revision": 1,
      "sets": [
        {
          "config": "production",
          "stage": "post_deploy"
        }
      ],
      "source": "person",
      "version_ref": {
        "revision": 1,
        "template_id": 12
      }
    }
  ]
}
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