CorefinityCorefinityDocs
Open the Control PanelControl Panel
Enterprise copies · 4 of 5

Finish an Enterprise copy

Ends a copy whose run has ended, while the site is still protected, its scheduled tasks are off and no domain is attached; the site stays an ordinary protected site with the copied data. A finished copy cannot be finished again, but while it is the site's latest copy it can still be re-synced, which makes a new copy.

POST/api/enterprise-copies/{copy}/finish

Path parameters

copyintegerRequired

The id of a copy, as a start or a re-sync answers it. Digits only; 0 or an id above 2147483647 is refused 422.

Returns

200 The copy is finished.

Fields of the 200 answer
copyobjectRequired
Fields
copiedobject or any or nullRequired

What the run copied. Null until it has ended.

copied_atstring or nullRequired

When the copy's run last ended. A copy's times are sent in UTC with a +00:00 offset, not Z. Format: date-time.

copy_ofinteger or nullRequired

The copy this one followed, when it was made by a re-sync. At least 1.

created_atstring or nullRequired

When the copy was started. Format: date-time.

database_bytesinteger or nullRequired

The size of the environment's database, measured when the copy started.

errorstring or nullRequired

For a failed copy, what happened and what to do next.

failure_reasonstring or nullRequired

For a failed copy, the stable code of why.

files_bytesinteger or nullRequired

The size of the environment's files, measured when the copy started.

finishablebooleanRequired

Whether the copy itself is ready to be finished. The site's own checks are made when you finish it.

finished_atstring or nullRequired

When the copy was finished. Format: date-time.

idintegerRequired

At least 1.

operationobject or any or nullRequired

The copy's run, as an operation of the site.

phasestringRequired

presync until the copy ends, then done (finished, or followed by a newer copy) or failed.

source_environment_idintegerRequired

At least 1.

statestringRequired

running while the copy runs, waiting once its run has ended, failed when it failed.

stepstring or nullRequired

Where the copy is: guard, transfer, fixups and check while it runs, copied once its run has ended, superseded when a re-sync followed it, finished when it was finished.

superseded_byinteger or nullRequired

The copy a re-sync made after this one. At least 1.

target_cluster_idintegerRequired

At least 1.

target_site_idintegerRequired

At least 1.

unactivated_atstring or nullRequired

When the site was last checked to be a copy and not a live site. Format: date-time.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404noneCheck the id. You see only what your account can reach.
409copy_endedThe copy has ended already. Start a new copy.
409copy_runningThe copy is still running. Wait for its run to end.
409copy_uncheckedThe copy's checks did not complete, so it cannot be finished. Re-sync it.
409target_crons_onThe site to copy into has its scheduled tasks on. Switch them off before copying into it.
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 -X POST https://manage.corefinity.com/api/enterprise-copies/6201/finish \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "copy": {
    "copied": {
      "at": "2026-11-03T12:41:07+00:00",
      "dangling_links": 0,
      "db_bytes": 10522669875,
      "duration_seconds": 2467,
      "files_bytes": 31876710400,
      "neutralised_at": "2026-11-03T12:40:12+00:00",
      "unreadable_files": 0
    },
    "copied_at": "2026-11-03T12:41:07+00:00",
    "copy_of": null,
    "created_at": "2026-11-03T12:00:00+00:00",
    "database_bytes": 10737418240,
    "error": null,
    "failure_reason": null,
    "files_bytes": 32212254720,
    "finishable": false,
    "finished_at": "2026-11-03T15:02:44+00:00",
    "id": 6201,
    "operation": {
      "id": 5141,
      "status": "completed",
      "step": "checked"
    },
    "phase": "done",
    "source_environment_id": 1311,
    "state": "waiting",
    "step": "finished",
    "superseded_by": null,
    "target_cluster_id": 1017,
    "target_site_id": 1081,
    "unactivated_at": "2026-11-03T12:41:05+00:00"
  }
}
Try it

Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT