CorefinityCorefinityDocs
Open the Control PanelControl Panel
Deployment pipeline · 12 of 15

List a pipeline's versions

Answers the pipeline's kept versions, newest first: who saved each, which stages it changed and whether it can be restored. Every kept version is on one page.

GET/api/corestack/sites/{site}/deployments/pipeline/{binding}/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.

bindingintegerRequired

The id of one of the environment's pipelines, as the pipeline read answers it in binding_id and bindings[].id. Digits only. At least 1.

Query parameters

stagestring

Only the versions that changed this stage or the settings.

builddatabasepost_deploy

Returns

200 The versions.

Fields of the 200 answer
dataarray of objectsRequired
Fields of each item
atstringRequired
bystring or null

The name of the person who saved it.

changedarray of stringsRequired

The stages this version changed, and settings.

numberintegerRequired

The version's number in this pipeline, counting from 1.

restorablebooleanRequired
restorable_reasonstring or null

Why not, when it cannot be restored.

sourcestring

How the version was made, such as editor, restore or template.

templateobject

For a version a deployment template wrote, the template (template_id) and its revision (template_revision).

version_idintegerRequired
next_cursorany or nullRequired

Always 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/sites/1042/deployments/pipeline/2210/versions \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "data": [
    {
      "at": "2026-11-09T10:42:07Z",
      "by": "Maya Okafor",
      "changed": [
        "settings"
      ],
      "number": 2,
      "restorable": false,
      "restorable_reason": "This is the current version.",
      "source": "editor",
      "version_id": 5002
    },
    {
      "at": "2026-11-02T09:15:30Z",
      "by": "Maya Okafor",
      "changed": [
        "post_deploy"
      ],
      "number": 1,
      "restorable": true,
      "restorable_reason": null,
      "source": "editor",
      "version_id": 5001
    }
  ],
  "next_cursor": null
}
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