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.
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.
Query parameters
Items a page: 1 to 100, default 20.
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
Send as cursor to read the next page. Null on the last page.
Fields of each item
Fields
The connected app, for an AI assistant.
Who made it: a person, an AI assistant (mcp_token, oauth), Corefinity, or an automatic change.
usermcp_tokenoauthcorefinityautomaticFormat: date-time.
Web server errors logged while it was live. Null when logs are not available.
The parts this revision changed, by name, such as server.
At least 1.
How the revision came about.
editorrevertcopyenv_createmoveclonemove_corefinityrepository_versionsystem_revertWhere 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_dormantIf 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. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/revisions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/revisions', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.get(
"https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/revisions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"cursor": [
"cursor is the next_cursor of the page before."
]
},
"field": "cursor",
"message": "cursor is the next_cursor of the page before.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}