Get a site's error pages
Answers which errors show a page of yours or of the platform and which show the application's own answer, the pages, the version every change sends back, and the latest change.
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.
Returns
200 The site's error pages. tags is shortened here.
Fields of the 200 answer
The revision the site serves now.
Whether the site can use error pages yet.
Whether you may change the pages now.
A site's error pages configuration.
Fields
For each status code, whether a visitor gets an error page (page) or the application's own answer (app).
Fields
pageapppageapppageapppageapppageappThe maintenance page and the page of each code.
Fields
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Fields
One line of plain text the page shows through the {{message}} tag, at most 300 characters. Null shows the default message.
Your own HTML for the page, at most 64 KiB (65,536 bytes), and all pages at most 256 KiB together. Null shows the platform's page.
Shown where a page uses the {{support_email}} tag. Up to 254 characters.
Fields
The largest one page may be.
The largest all pages may be together.
Set while Corefinity has locked the site's error pages: you can read, preview and test them, and changes are refused. Null otherwise.
The latest change. Null when there has been none.
Each page at a glance.
Fields of each item
The last revision that changed the page. Null when none has.
maintenance404500502503504The platform's page, your own, or the application's own answer.
platformcustomappThe saved revision. Null while the site is on the platform defaults.
At least 1.
What the {{site_name}} tag shows.
The tags a page may use.
Fields of each item
Why not, when available is false, such as runtime while the site waits for a platform update.
Send it back with every change.
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. |
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/error-pages \
-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/error-pages');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/error-pages', {
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/error-pages",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"applied_revision_id": 312,
"available": true,
"can_change": true,
"config": {
"codes": {
"404": "app",
"500": "page",
"502": "page",
"503": "page",
"504": "page"
},
"pages": {
"404": {
"message": null,
"source": null
},
"500": {
"message": null,
"source": null
},
"502": {
"message": null,
"source": null
},
"503": {
"message": null,
"source": "<!DOCTYPE html><html><head><meta name=\"viewport\" content=\"width=device-width\"><title>Back soon</title></head><body><h1>Back soon</h1><p>{{message}}</p></body></html>"
},
"504": {
"message": null,
"source": null
},
"maintenance": {
"message": null,
"source": null
}
},
"support_email": null
},
"limits": {
"page_bytes": 65536,
"row_bytes": 262144
},
"locked": null,
"operation": {
"can_retry": false,
"completed_at": "2026-11-06T09:17:03Z",
"created_at": "2026-11-06T09:16:40Z",
"error": null,
"id": 5119,
"outcome": "applied",
"status": "completed",
"steps": [
{
"at": "2026-11-06T09:16:40Z",
"detail": "No problems",
"key": "check",
"label": "Check",
"state": "done"
},
{
"at": "2026-11-06T09:16:41Z",
"detail": null,
"key": "commit",
"label": "Commit",
"state": "done"
},
{
"at": "2026-11-06T09:16:58Z",
"detail": null,
"key": "apply",
"label": "Apply",
"state": "done"
},
{
"at": "2026-11-06T09:17:03Z",
"detail": "Checked on your site",
"key": "verify",
"label": "Verify",
"state": "done"
}
]
},
"pages": [
{
"bytes": 0,
"changed": null,
"id": "maintenance",
"state": "platform",
"warnings": 0
},
{
"bytes": 0,
"changed": null,
"id": "404",
"state": "app",
"warnings": 0
},
{
"bytes": 0,
"changed": null,
"id": "500",
"state": "platform",
"warnings": 0
},
{
"bytes": 0,
"changed": null,
"id": "502",
"state": "platform",
"warnings": 0
},
{
"bytes": 169,
"changed": {
"at": "2026-11-02T15:41:09Z",
"by": "Eleanor Finch",
"revision": 2
},
"id": "503",
"state": "custom",
"warnings": 0
},
{
"bytes": 0,
"changed": null,
"id": "504",
"state": "platform",
"warnings": 0
}
],
"revision": {
"author": "Eleanor Finch",
"created_at": "2026-11-02T15:41:09Z",
"id": 312,
"note": "Our own 503 page",
"number": 2,
"origin": "save"
},
"site_id": 1042,
"site_name": "harbourandfinch.example.com",
"tags": [
{
"description": "The status code of this page, for example 503.",
"scope": "compile",
"tag": "{{status_code}}"
},
{
"description": "The message you set for this page.",
"scope": "compile",
"tag": "{{message}}"
}
],
"unavailable_reason": null,
"version": 2
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "Too many attempts on this environment. Try again shortly.",
"reason": "rate_limited",
"retry_after_seconds": 60
}