CorefinityCorefinityDocs
Open the Control PanelControl Panel
Enterprise deployments · 4 of 17

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.

GET/api/environments/{environment}/deployments

Path parameters

environmentintegerRequired

The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.

Query parameters

limitinteger

Items a page: 1 to 100, default 25. Sending it pages the list.

cursorstring

The next_cursor of the previous answer. At most 40 characters; a cursor the list did not give you is refused 422 on cursor.

statusstring

Only deployments in this status. pending is a deployment that waits to be deployed by hand.

scheduledrunningfailedsucceededcancelledpendingqueued

Returns

200 The deployments. next_cursor is present only when the list is paged.

Fields of the 200 answer
deploymentsarray of objectsRequired
Fields of each item
artifact_pruned_atstring or nullRequired

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.

attempt_idinteger or nullRequired

The run the deployment is on now. A retry starts a new run with a new id. Null while the deployment has no run.

environment_deployment_pipeline_idstringRequired

The pipeline the deployment runs on, as the pipelines list names it.

environment_idstringRequired
errorstring or nullRequired

Why a failed deployment failed, as the last line of the step that stopped it. Null unless it failed.

git_authorobject or any or nullRequired

The commit's author, when the push gave one.

git_commitstring or nullRequired

The commit deployed. Null for an uploaded archive.

git_commit_urlstring or nullRequired

The commit's page at the git provider, when the push that started the deployment gave it.

git_merge_requestobject or any or nullRequired

The merge request or pull request of the commit, when the push gave one.

hashstring or nullRequired

The deployment's own identifier.

idstringRequired
namestring or nullRequired
notesstring or nullRequired
statusstringRequired

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.

1234567
status_descriptionstring or nullRequired

The name of the status.

ScheduledRunningFailedSucceededCancelledPendingQueuednull
next_cursorstring or null

Present 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

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
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/environments/1311/deployments \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "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"
    }
  ]
}
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