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.
Path parameters
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
now (the default) or tonight; window means tonight while maintenance windows are on for your company. Defaults to now.
nowtonightwindowReturns
201 The move started (operation), or was queued for the site's window (queued).
Fields of the 201 answer
Whether a site is on the runtime, and whether it can move onto it.
Fields
Why the site cannot move at once, when it cannot.
True when the site is on the runtime.
The date Corefinity plans to move the site, if one is set.
The date of the window the move is queued for, if it is queued.
The runtime revision the site is on, such as v1. Null until it is on the runtime.
At least 1.
The operation that moves the site: read it by its id with GET /. It is the operation of the site's window, so its scope is batch. Null when the move was queued.
Fields
At least 1.
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_outexecutingcompletedfailedSent only when the move waits for the site's window.
The date of the window the move waits for. Null when no window has been set for it yet.
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 | feature_off | This feature is not on for your organisation yet. |
409 | already_adopted | Instant changes are already on for this environment. |
422 | invalid | Fix the field named in field; errors says why. |
422 | feature_off | This feature is not on for your organisation yet. |
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/sites/1042/runtime/adopt \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"apply": "now"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/runtime/adopt', [
'apply' => 'now',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/runtime/adopt', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
apply: 'now',
}),
});
// 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/sites/1042/runtime/adopt",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"apply": "now",
},
)
data = res.json() if res.content else None{
"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"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"adoption": {
"adopt_now_refusal": null,
"adopted": true,
"can_adopt_now": false,
"can_adopt_tonight": false,
"in_progress": false,
"planned_for": null,
"queued_for": null,
"revision": "v1"
},
"code": "already_adopted",
"message": "Instant changes are already on for this environment.",
"reason": "already_adopted"
}{
"code": "invalid",
"errors": {
"apply": [
"The selected apply is invalid."
]
},
"field": "apply",
"message": "The selected apply is invalid.",
"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 has not been cleared for the console. Copy the request and run it yourself when you are sure.