Move Corefinity's rules into yours
Moves the rules Corefinity set up for the site (corefinity_rules in the read) into your own server hook, where you can edit them. Only blocks that answer every address exactly as before can move. The move always applies at once and takes about a minute.
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
Only now: a move cannot wait for a window. Defaults to now.
nowThe from_line of each block to move. Every block that can move when left out.
A passed test run of the same content, from a check, so it is not run again. At least 1.
The version from the last read. At least 0.
Returns
201 The move started. Follow operation.
Fields of the 201 answer
The id of the queued change.
The change to follow. Null when nothing was started.
On a copy that carried path apps: the records that were not carried (path_app_not_carried).
Present when the change waits for a window.
The new revision. Null when there is none.
The window a queued change waits for. Present only while maintenance windows are on for your company.
The date of the window a queued change waits for.
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 | busy | Another operation is running on the site. Wait for it to finish. |
409 | conflict | The action conflicts with the object's present state. Read the message. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | not_running | The site, environment or deployment is not running. Read the message: where it can be started or will recover, start it or wait, then try again. |
409 | restore_running | A restore is running on the site. Wait for it to finish, then try again. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
422 | feature_off | This feature is not on for your organisation yet. |
422 | invalid | Fix the field named in field; errors says why. |
422 | nginx_invalid | These nginx rules cannot be saved: fix the errors shown. |
422 | nginx_rules_locked | Corefinity has locked this environment's nginx rules. Contact support to change them. |
422 | not_admitted | This change cannot be scheduled for tonight. |
429 | rate_limited | Wait for the seconds in Retry-After. |
500 | none | Read the message; it says what happened. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/corefinity-rules/move \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"version": 0
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/corefinity-rules/move', [
'version' => 0,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/corefinity-rules/move', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
version: 0,
}),
});
// 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/nginx-rules/corefinity-rules/move",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"version": 0,
},
)
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-06T09:16:40Z",
"completed_at": null,
"created_at": "2026-11-06T09:16:40Z",
"environment": {
"env_id": "rs-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": 5122,
"install": null,
"label": "Picked up by the platform",
"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": null,
"retry_requires": null,
"revealed": null,
"scope": "site",
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"status": "committed",
"status_label": "Waiting for the platform",
"step": "applied",
"steps": [
{
"key": "tested",
"label": "Tested",
"state": "done"
},
{
"key": "saved",
"label": "Saved",
"state": "done"
},
{
"key": "applied",
"label": "Picked up by the platform",
"state": "current"
},
{
"key": "restarted",
"label": "Change applied",
"state": "todo"
},
{
"key": "healthy",
"label": "Healthy",
"state": "todo"
},
{
"key": "checked",
"label": "Checked",
"state": "todo"
},
{
"key": "verified",
"label": "Verified",
"state": "todo"
}
],
"subject": null,
"summary": "Move Corefinity rules",
"to_version": null,
"type": "nginx_rules_move",
"type_label": "Move Corefinity rules"
},
"revision": {
"id": 319,
"number": 1,
"status": "saving"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "feature_off",
"message": "Queuing changes for the maintenance window is switched off at the moment",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "Too many attempts on this environment. Try again shortly.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "Server Error"
}{
"message": "The change could not be saved. Contact support."
}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.