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.
Path parameters
The id of a company you belong to or manage. Digits only. At least 1.
The platform the template is for, such as magento2, laravel or wordpress. The list answers the ones your company can have.
Query parameters
The next_cursor of the previous answer, a whole number here. Anything else is refused 422 invalid on cursor. 0 to 999999.
With stage, only the versions that changed that stage of this configuration.
productionuatWith config.
builddatabasepost_deploysettingscorefinity answers the versions of Corefinity's default instead. Not with config and stage.
corefinityReturns
200 A page of versions.
Fields of the 200 answer
Fields of each item
With level corefinity, when that version came into use, in UTC. Format: date-time.
The name of the person who saved it.
The stages this version changed.
Fields of each item
How many environments the version was written to.
The revision this one restored, when it is a restore.
The stages the template set after this version.
Fields of each item
Who made the version, such as person.
With level corefinity, the number of Corefinity's version. At least 1.
Fields
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/companies/1204/deploy-templates/magento2/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/companies/1204/deploy-templates/magento2/versions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/companies/1204/deploy-templates/magento2/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/companies/1204/deploy-templates/magento2/versions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}
}
]
}{
"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": {
"level": [
"Filter by level, or by one configuration and stage."
]
},
"field": "level",
"message": "Filter by level, or by one configuration and stage.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}