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

Get one Nginx revision

Answers one revision with the text of its hooks and a unified diff of each hook against the current revision, or against another one.

GET/api/corestack/sites/{site}/nginx-rules/revisions/{revision}

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.

revisionintegerRequired

The id of a revision of this site, from the list's id. At least 1.

Query parameters

againststring

The id of the revision to compare with, or current (the default).

Returns

200 The revision and its differences.

Fields of the 200 answer
againstobjectRequired

The revision it is compared with.

Fields
currentbooleanRequired
idinteger or nullRequired
diffobjectRequired

A unified diff per hook. Null where a hook agrees.

revisionobjectRequired

One revision in the site's history.

Fields
authorobjectRequired
Fields
clientstring or nullRequired

The connected app, for an AI assistant.

kindstringRequired

Who made it: a person, an AI assistant (mcp_token, oauth), Corefinity, or an automatic change.

usermcp_tokenoauthcorefinityautomatic
namestringRequired
created_atstring or nullRequired

Format: date-time.

errors_sinceinteger or nullRequired

Web server errors logged while it was live. Null when logs are not available.

hooks_changedarray of stringsRequired

The parts this revision changed, by name, such as server.

idintegerRequired

At least 1.

notestring or nullRequired
numberintegerRequired
originstringRequired

How the revision came about.

editorrevertcopyenv_createmoveclonemove_corefinityrepository_versionsystem_revert
statusstringRequired

Where a revision stands: saving while it is being applied, pending_verify until it has been checked, applied when live, superseded once a later one is, rejected, verify_failed or rolled_back when it failed and the rules before it were put back, not_committed when it was never saved, saved_dormant when saved and waiting for a runtime update.

savingpending_verifyappliedrejectedverify_failedrolled_backsupersedednot_committedsaved_dormant
status_reasonstring or nullRequired
contentobjectRequired

The text of each part the revision holds, by name.

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.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/revisions/1 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "against": {
    "current": true,
    "id": 317
  },
  "diff": {
    "headers": null,
    "http": null,
    "php": null,
    "server": "--- revision 2\n+++ revision 1\n@@ -1,3 +1,3 @@\n-location = /older {\n-    return 410;\n+location = /old {\n+    return 404;\n }\n"
  },
  "revision": {
    "author": {
      "client": null,
      "kind": "user",
      "name": "Eleanor Finch"
    },
    "content": {
      "headers": null,
      "http": null,
      "php": null,
      "server": "location = /old {\n    return 404;\n}\n"
    },
    "created_at": "2026-11-01T10:02:11Z",
    "errors_since": null,
    "hooks_changed": [
      "server"
    ],
    "id": 316,
    "note": "First rules",
    "number": 1,
    "origin": "editor",
    "status": "applied",
    "status_reason": null
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT