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

Retry a deployment

Runs the deployment again and answers it with status 7 (Queued). Retrying a deployment that is not the environment's newest puts an older release live, so it needs confirm_older true. Your role needs the Retry Deployments permission. On an environment of a CoreStack or CoreCluster site the site's own rules apply: whoever may deploy the site can retry a failed deployment, or one that was stopped in its after-deploy commands once its release was live (the site's can_retry).

POST/api/environments/{environment}/deployments/{deployment}/retry
  • Needs deploy as well: Always.

Path parameters

environmentintegerRequired

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

deploymentintegerRequired

The id of a deployment of the environment. A deployment of another environment is not found. At least 1.

Idempotency-Keystring

A UUID you choose, to make the request safe to repeat. Only the endpoints that list this header read it; each says what a repeated key answers. Format: uuid.

Body

confirm_olderboolean

True to retry a deployment that is not the environment's newest.

expected_action_idinteger or null

The attempt_id you read. If the deployment has moved on since, the answer is 409 stale and nothing happens. At least 1.

fromstring

start runs the whole pipeline again. failed_step carries on from the step that failed, where the deployment's view.actions lists retry_from_step. A key used for one is a different request for the other. Defaults to start.

startfailed_step

Returns

200 The deployment, queued again. replayed is true when the Idempotency-Key was used before.

Fields of the 200 answer
deploymentobjectRequired

A deployment of a CoreStack Enterprise environment. Ids are strings here, except attempt_id.

Fields
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
replayedbooleanRequired

True when this answer repeats the outcome of an earlier request with the same Idempotency-Key.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403forbiddenThe person is not allowed to do this.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
409staleWhat you read has changed since you read it. Read it again, then send the change with its new version or quote.
409artifact_prunedThe deployment's archive was removed after 30 days, so it cannot be retried or rolled back. Deploy again from the branch or commit.
409conflictThe action conflicts with the object's present state. Read the message.
409pipeline_changed_since_buildThe pipeline changed after this deployment was built. Deploy again instead of retrying.
422confirmThe action needs an explicit confirmation field. Ask the person, then send it.
422invalidFix the field named in field; errors says why.
422retry_from_step_unavailableThis deployment cannot be retried from the step that failed. Retry it from the start, or deploy again.
429rate_limitedWait for the seconds in Retry-After.
500internal_errorSomething went wrong on our side. Quote the trace id to support.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/environments/1311/deployments/4410/retry \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "confirm_older": true
  }'
{
  "deployment": {
    "artifact_pruned_at": null,
    "attempt_id": 190422,
    "environment_deployment_pipeline_id": "2210",
    "environment_id": "1311",
    "error": null,
    "git_author": {
      "avatar_url": null,
      "name": "Maya Okafor"
    },
    "git_commit": "5c1d0e9a7b3f42d68a0c9e1f7b2d4a6c8e0f1a3b",
    "git_commit_url": "https://git.example.com/northwind-digital/harbourandfinch-trade/commit/5c1d0e9a7b3f42d68a0c9e1f7b2d4a6c8e0f1a3b",
    "git_merge_request": {
      "kind": "pull_request",
      "ref": "#42",
      "url": "https://git.example.com/northwind-digital/harbourandfinch-trade/pull/42"
    },
    "hash": "a1ad2149-9907-53b6-ba91-5b042673f595",
    "id": "4410",
    "name": "Release 2026.10.4",
    "notes": null,
    "status": "7",
    "status_description": "Queued"
  },
  "replayed": false
}
Try it

Try it is off for this endpointIt runs commands on a live site. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT