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

List a site's Nginx revisions

Lists the revisions of the site's Nginx rules, newest first. Paged by cursor: send next_cursor back as cursor; null means the last page.

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

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.

Query parameters

limitinteger

Items a page: 1 to 100, default 20.

cursorstring

The next_cursor of the previous answer. Send only a cursor the list gave you; the list's own page says what any other value answers.

Returns

200 A page of revisions.

Fields of the 200 answer
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

dataarray of objectsRequired
Fields of each item
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

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 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "data": [
    {
      "author": {
        "client": null,
        "kind": "user",
        "name": "Eleanor Finch"
      },
      "created_at": "2026-11-02T15:41:09Z",
      "errors_since": null,
      "hooks_changed": [
        "server"
      ],
      "id": 317,
      "note": null,
      "number": 2,
      "origin": "editor",
      "status": "applied",
      "status_reason": null
    },
    {
      "author": {
        "client": null,
        "kind": "user",
        "name": "Eleanor Finch"
      },
      "created_at": "2026-11-01T10:02:11Z",
      "errors_since": null,
      "hooks_changed": [
        "server"
      ],
      "id": 316,
      "note": "First rules",
      "number": 1,
      "origin": "editor",
      "status": "superseded",
      "status_reason": null
    }
  ],
  "next_cursor": 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