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.
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
committed takes the changed rules as your saved rules; panel keeps your saved rules.
committedpanelThe 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
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.
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 | inventory_behind | The files changed again after they were read. Read them again, then choose again. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
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 | invalid | Fix the field named in field; errors says why. |
422 | nginx_rules_locked | Corefinity has locked this environment's nginx rules. Contact support to change them. |
422 | no_drift | The files are the ones the Control Panel last committed: there is no change made outside it to answer. Nothing to do. |
429 | rate_limited | Wait for the seconds in Retry-After. |
503 | upstream_unavailable | A 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
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/drift', [
'action' => 'panel',
'version' => 3,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/drift', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
action: 'panel',
version: 3,
}),
});
// 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/drift",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"action": "panel",
"version": 3,
},
)
data = res.json() if res.content else None{
"operation": null,
"revision": null
}{
"operation": null,
"revision": {
"id": 320,
"number": 2,
"status": "pending_verify"
}
}{
"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": "invalid",
"errors": {
"action": [
"action is committed or panel."
]
},
"field": "action",
"message": "action is committed or panel.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many attempts on this environment. Try again shortly.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "upstream_unavailable",
"message": "This environment's configuration repository can't be read right now. Try again in a few minutes.",
"reason": "upstream_unavailable"
}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.