CorefinityCorefinityDocs
Open the Control PanelControl Panel
Web server rules · 7 of 19

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.

POST/api/corestack/sites/{site}/nginx-rules/corefinity-rules/move

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

Only now: a move cannot wait for a window. Defaults to now.

now
blocksarray of integers or null

The from_line of each block to move. Every block that can move when left out.

test_idinteger

A passed test run of the same content, from a check, so it is not run again. At least 1.

versionintegerRequired

The version from the last read. At least 0.

Returns

201 The move started. Follow operation.

Fields of the 201 answer
item_idinteger or null

The id of the queued change.

operationobject or any or nullRequired

The change to follow. Null when nothing was started.

path_app_warningsarray of objects

On a copy that carried path apps: the records that were not carried (path_app_not_carried).

queuedboolean

Present when the change waits for a window.

revisionobject or any or nullRequired

The new revision. Null when there is none.

windowobject or any or null

The window a queued change waits for. Present only while maintenance windows are on for your company.

window_datestring or null

The date of the window a queued change waits for.

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.
409busyAnother operation is running on the site. Wait for it to finish.
409conflictThe action conflicts with the object's present state. Read the message.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409not_runningThe 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.
409restore_runningA restore is running on the site. Wait for it to finish, then try again.
409staleWhat you read has changed since you read it. Read it again, then send the change with its new version or quote.
422feature_offThis feature is not on for your organisation yet.
422invalidFix the field named in field; errors says why.
422nginx_invalidThese nginx rules cannot be saved: fix the errors shown.
422nginx_rules_lockedCorefinity has locked this environment's nginx rules. Contact support to change them.
422not_admittedThis change cannot be scheduled for tonight.
429rate_limitedWait for the seconds in Retry-After.
500noneRead the message; it says what happened.
502noneRead 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
  }'
{
  "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"
  }
}
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