CorefinityCorefinityDocs
Open the Control PanelControl Panel
PHP · 11 of 11

Move a site onto the runtime

Moves the site onto the runtime, at once or in the site's window. The runtime summary says whether it can (adoption.can_adopt_now, adoption.can_adopt_tonight). A site that cannot move is refused 409 with the reason and its adoption state.

POST/api/corestack/sites/{site}/runtime/adopt

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Body

applystring

now (the default) or tonight; window means tonight while maintenance windows are on for your company. Defaults to now.

nowtonightwindow

Returns

201 The move started (operation), or was queued for the site's window (queued).

Fields of the 201 answer
adoptionobjectRequired

Whether a site is on the runtime, and whether it can move onto it.

Fields
adopt_now_refusalstring or nullRequired

Why the site cannot move at once, when it cannot.

adoptedbooleanRequired

True when the site is on the runtime.

can_adopt_nowbooleanRequired
can_adopt_tonightbooleanRequired
in_progressbooleanRequired
planned_forstring or nullRequired

The date Corefinity plans to move the site, if one is set.

queued_forstring or nullRequired

The date of the window the move is queued for, if it is queued.

revisionstring or nullRequired

The runtime revision the site is on, such as v1. Null until it is on the runtime.

item_idinteger or null

At least 1.

operationobject or nullRequired

The operation that moves the site: read it by its id with GET /corestack/operations/{operation}. It is the operation of the site's window, so its scope is batch. Null when the move was queued.

Fields
idinteger

At least 1.

statusstring

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_outexecutingcompletedfailed
typestring
queuedboolean

Sent only when the move waits for the site's window.

windowobject or any or null
window_datestring or null

The date of the window the move waits for. Null when no window has been set for it yet.

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.
404feature_offThis feature is not on for your organisation yet.
409already_adoptedInstant changes are already on for this environment.
422invalidFix the field named in field; errors says why.
422feature_offThis feature is not on for your organisation yet.
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/corestack/sites/1042/runtime/adopt \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "apply": "now"
  }'
{
  "adoption": {
    "adopt_now_refusal": null,
    "adopted": false,
    "can_adopt_now": true,
    "can_adopt_tonight": false,
    "in_progress": false,
    "planned_for": null,
    "queued_for": "2026-11-04",
    "revision": null
  },
  "item_id": 5120,
  "operation": null,
  "queued": true,
  "window_date": "2026-11-04"
}
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