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

Answer a change made outside

Answers a change to the site's Nginx rules that was made outside the Control Panel (drift in the read). committed takes the changed rules as your saved rules, as a new revision that is then checked like any change. panel keeps your saved rules: nothing is written, and your next save writes them again.

POST/api/corestack/sites/{site}/nginx-rules/drift

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

actionstringRequired

committed takes the changed rules as your saved rules; panel keeps your saved rules.

committedpanel
versionintegerRequired

The version from the last read. At least 0.

Returns

200 panel: your saved rules stay as they are.

201 committed: the changed rules are a new revision, pending_verify until they have been checked.

Fields of the 200 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.

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.
409inventory_behindThe files changed again after they were read. Read them again, then choose again.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409staleWhat you read has changed since you read it. Read it again, then send the change with its new version or quote.
422invalidFix the field named in field; errors says why.
422nginx_rules_lockedCorefinity has locked this environment's nginx rules. Contact support to change them.
422no_driftThe files are the ones the Control Panel last committed: there is no change made outside it to answer. Nothing to do.
429rate_limitedWait for the seconds in Retry-After.
503upstream_unavailableA service the action depends on did not answer. Try again later.

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/drift \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "panel",
    "version": 3
  }'
{
  "operation": null,
  "revision": null
}
Try it

Try it is off for this endpointIt overwrites data that cannot be brought back. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT