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.
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.
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
Only the versions that changed this stage or the settings.
builddatabasepost_deployReturns
200 The versions.
Fields of the 200 answer
Fields of each item
The name of the person who saved it.
The stages this version changed, and settings.
The version's number in this pipeline, counting from 1.
Why not, when it cannot be restored.
How the version was made, such as editor, restore or template.
For a version a deployment template wrote, the template (template_id) and its revision (template_revision).
Always null.
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. |
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/deployments/pipeline/2210/versions \
-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/deployments/pipeline/2210/versions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/deployments/pipeline/2210/versions', {
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/deployments/pipeline/2210/versions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"stage": [
"Choose build, database or post_deploy."
]
},
"field": "stage",
"message": "Choose build, database or post_deploy.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}