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.
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.
The id of a revision of this site, from the list's id. At least 1.
Query parameters
The id of the revision to compare with, or current (the default).
Returns
200 The revision and its differences.
Fields of the 200 answer
The revision it is compared with.
Fields
A unified diff per hook. Null where a hook agrees.
One revision in the site's history.
Fields
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_dormantThe text of each part the revision holds, by name.
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. |
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/1 \
-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/1');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/revisions/1', {
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/1",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}
}{
"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": {
"against": [
"against is current or a revision of this environment."
]
},
"field": "against",
"message": "against is current or a revision of this environment.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}