Retry a failed operation
Retries a site's failed operation from where it stopped and answers the new attempt to follow. Site and environment creations, operations already retried and a CoreCluster's own operations cannot be retried here.
- Needs
destructiveas well: The failed operation is a site delete, an environment delete or a copy onto production.
Path parameters
The id of an operation. Digits only. At least 1.
Body
Send true once you have checked that the site's live .env file is the one to continue from. Needed only when the operation failed because that file changed under it (failure_reason is env_drift).
Returns
201 The new attempt.
Fields of the 201 answer
A change the Control Panel is making or has made. A save or an action that starts work answers one in operation; read it again by id with GET / until status is completed or failed. Both answers have this shape; the few endpoints that answer a different one say so.
Fields
The cluster the operation runs on.
Why the operation failed, in plain words. Null unless status is failed.
A stable code for the failure.
True when the change applies without a maintenance window.
What the operation did differently on purpose. Empty when nothing.
Fields of each item
Who asked for the change.
Present on some site creations and copies.
Always null here. A one-time result is read once with the reveal endpoint.
nonependingavailableviewedWhat a retry needs first, if anything.
Who revealed a one-time result and when, when there was one.
siteclusterbatchThe website the operation belongs to. Null for a cluster's own operation.
Where a change is. completed and failed are final; every other status means the change is still running and blocks another change to the same site.
pendingcommittedrolling_outexecutingcompletedfailedThe key of the step the operation is at. Null once it has completed.
Fields of each item
One of done, current, todo, failed or skipped.
The kind of change, such as crons_change or redirects_change.
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 | none | Check the id. You see only what your account can reach. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | cluster_paused | Changes on this site are paused for planned maintenance; please try again later. |
409 | deleted | The site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | provisioning | The site is still being created. Try again in a few minutes. |
409 | restore_running | A restore is running on the site. Wait for it to finish, then try again. |
422 | invalid | Fix the field named in field; errors says why. |
422 | not_retryable | The operation cannot be retried. |
422 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/operations/5120/retry \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"acknowledge_env": true
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/operations/5120/retry', [
'acknowledge_env' => true,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/operations/5120/retry', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
acknowledge_env: true,
}),
});
// 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.post(
"https://manage.corefinity.com/api/corestack/operations/5120/retry",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"acknowledge_env": True,
},
)
data = res.json() if res.content else None{
"operation": {
"applied_at": null,
"can_retry": false,
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"committed_at": "2026-11-03T09:12:05Z",
"completed_at": null,
"created_at": "2026-11-03T09:12:03Z",
"environment": {
"env_id": "rs-northwind-harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"error": null,
"failure_reason": null,
"from_version": null,
"hot": false,
"id": 5121,
"install": null,
"label": "Site URL updated",
"notes": [],
"parent_operation_id": null,
"requested_by": {
"id": 2041,
"name": "Eleanor Finch"
},
"reset_target": null,
"result": null,
"result_state": "none",
"retried_by_operation_id": null,
"retries_operation_id": 5120,
"retry_requires": null,
"revealed": null,
"scope": "site",
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"status": "executing",
"status_label": "Running",
"step": "rewritten",
"steps": [
{
"key": "committed",
"label": "New address added",
"state": "done"
},
{
"key": "rewritten",
"label": "Site URL updated",
"state": "current"
},
{
"key": "finalising",
"label": "Redirect saved",
"state": "todo"
},
{
"key": "finalised",
"label": "Old address redirects",
"state": "todo"
}
],
"subject": null,
"summary": "Primary URL",
"to_version": null,
"type": "url_change",
"type_label": "Primary URL"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "invalid",
"errors": {
"acknowledge_env": [
"acknowledge_env_required"
]
},
"field": "acknowledge_env",
"message": "Check the .env file, then confirm it is the one to continue from",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt overwrites data that cannot be brought back. Copy the request and run it yourself when you are sure.