List an environment's deployments
Without limit, cursor or status the answer is every deployment of the environment, oldest first, with no next_cursor. Send any of the three and the list is paged instead, newest first. Paged by cursor: send next_cursor back as cursor; null means the last page.
Path parameters
The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.
Query parameters
Items a page: 1 to 100, default 25. Sending it pages the list.
The next_cursor of the previous answer. At most 40 characters; a cursor the list did not give you is refused 422 on cursor.
Only deployments in this status. pending is a deployment that waits to be deployed by hand.
scheduledrunningfailedsucceededcancelledpendingqueuedReturns
200 The deployments. next_cursor is present only when the list is paged.
Fields of the 200 answer
Fields of each item
When the deployment's release archive was removed. A deployment with one cannot be retried or rolled back to. Null while the archive is kept.
The run the deployment is on now. A retry starts a new run with a new id. Null while the deployment has no run.
The pipeline the deployment runs on, as the pipelines list names it.
Why a failed deployment failed, as the last line of the step that stopped it. Null unless it failed.
The commit's author, when the push gave one.
The commit deployed. Null for an uploaded archive.
The commit's page at the git provider, when the push that started the deployment gave it.
The merge request or pull request of the commit, when the push gave one.
The deployment's own identifier.
The status as a number in a string: 1 Scheduled, 2 Running, 3 Failed, 4 Succeeded, 5 Cancelled, 6 Pending (waiting to be deployed by hand), 7 Queued.
1234567The name of the status.
ScheduledRunningFailedSucceededCancelledPendingQueuednullPresent only when the list is paged, which is why this list does not compose the shared CursorPage. Send it as cursor to read the next page. Null on the last page.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
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/environments/1311/deployments \
-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/environments/1311/deployments');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/environments/1311/deployments', {
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/environments/1311/deployments",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"deployments": [
{
"artifact_pruned_at": null,
"attempt_id": 190388,
"environment_deployment_pipeline_id": "2210",
"environment_id": "1311",
"error": null,
"git_author": null,
"git_commit": "0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b",
"git_commit_url": null,
"git_merge_request": null,
"hash": "2f0c7d5e-1b7a-4c38-9a55-0d6e2b8f4c11",
"id": "88190",
"name": "Release 2026.10.3",
"notes": null,
"status": "4",
"status_description": "Succeeded"
},
{
"artifact_pruned_at": null,
"attempt_id": 190419,
"environment_deployment_pipeline_id": "2210",
"environment_id": "1311",
"error": null,
"git_author": null,
"git_commit": "5c1d0e9a7b3f42d68a0c9e1f7b2d4a6c8e0f1a3b",
"git_commit_url": null,
"git_merge_request": null,
"hash": "71a7eaca-89a7-4a5f-a7af-17d38ca685e6",
"id": "4410",
"name": "Release 2026.10.4",
"notes": null,
"status": "3",
"status_description": "Failed"
}
]
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"cursor": [
"That page does not exist. Reload the list."
]
},
"field": "cursor",
"message": "That page does not exist. Reload the list.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}