Get one version of a pipeline
Answers the stages and settings as that version held them, with diff: for each stage that differs from the current pipeline, or from the version named in compare_to, its lines before and after, and under settings each setting that differs. diff is null when nothing differs. A version kept of a pipeline that did not have the three stages yet answers stages and settings null.
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.
The version_id of one of the pipeline's versions. Digits only. At least 1.
Query parameters
Another version_id to compare with, or current for the current pipeline, which is the default.
Returns
200 The version.
Fields of the 200 answer
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).
current, or the version_id compared with.
By stage that differs, its lines before (this version) and after (what it is compared with), and under settings, by setting that differs, its value before and after. Null when nothing differs.
The settings as the version held them. Null for a version kept of a pipeline that did not have the three stages yet.
The stages as the version held them. Null for a version kept of a pipeline that did not have the three stages yet.
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/5001 \
-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/5001');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/deployments/pipeline/2210/versions/5001', {
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/5001",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"at": "2026-11-09T10:42:07Z",
"by": "Maya Okafor",
"changed": [
"settings"
],
"compare_to": "current",
"diff": null,
"number": 2,
"restorable": false,
"restorable_reason": "This is the current version.",
"settings": {
"keep_node_modules": false,
"maintenance_policy": "off",
"pause_crons": "auto",
"run_migrations": null,
"timeouts": {
"build": 3600,
"build_line": 3600,
"database_line": 600,
"post_line": 600
},
"tunnels": "off"
},
"source": "editor",
"stages": {
"build": {
"effective": [],
"hooks": [],
"lines": [],
"mode": "preset",
"preset": {
"frontend": [],
"options": [],
"platform": "none"
}
},
"database": {
"lines": [],
"platform_step_at": 0
},
"post_deploy": {
"lines": [
{
"badges": [],
"comments": [],
"origin": "custom",
"text": "php artisan queue:restart",
"verdict": "services"
},
{
"badges": [
{
"id": "replaced_by_platform",
"label": "Replaced by a CoreStack step",
"severity": "info"
}
],
"comments": [],
"origin": "custom",
"text": "php artisan config:cache",
"verdict": "platform_duplicate"
}
]
}
},
"version_id": 5002
}{
"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": {
"compare_to": [
"Compare with current or with a version's id."
]
},
"field": "compare_to",
"message": "Compare with current or with a version's id.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}