CorefinityCorefinityDocs
Open the Control PanelControl Panel
Maintenance windows · 9 of 14

Get a site's maintenance window

Answers the window in force for the site, where it comes from, its next occurrence and whether you can change it. An environment answers its website's window.

GET/api/corestack/sites/{site}/maintenance-window

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.

Returns

200 The window.

Fields of the 200 answer
edit_refusalstring

Why the window cannot be changed. Sent only when editable is false.

window_scope_unavailableforbiddenwindow_locked
editablebooleanRequired
effectiveobjectRequired

The window in force, wherever it comes from.

Fields
end_hourintegerRequired

The hour the window closes. 0 to 23.

labelstringRequired

The window in words, such as 00:00–04:00 UK time.

length_hoursintegerRequired
sourcestringRequired

The level the window comes from. staff_lock is a window Corefinity has set, which cannot be changed here.

siteclusterstaff_lockcompanyplatform
source_labelstringRequired
staff_lockedbooleanRequired

True when Corefinity has set the window.

start_hourintegerRequired

The hour the window opens, in timezone. 0 to 23.

timezonestringRequired
inheritedobjectRequired

The window this level uses when it has none of its own.

Fields
levelstringRequired
websiteclustercompanyplatform
namestring or nullRequired
start_hourintegerRequired

0 to 23.

nextobject or any or nullRequired

The next occurrence of the window.

notice_periodobject or any or nullRequired

The notice period while it runs: until is its end, or null before it has a date. Null once it has passed.

ownobject or any or nullRequired

The start hour set at this level. Null when the level has none of its own and inherits.

pendingobjectRequired

Changes waiting for the window.

Fields
countintegerRequired
noticebooleanRequired

Whether you are told about them before they apply.

restampedinteger

Sent after a change: how many queued changes moved to the new window.

siteobjectRequired

A site by its id and domain.

Fields
domainstringRequired
idintegerRequired
snapshot_overlapobject or any or nullRequired

A scheduled snapshot that falls inside the window, with its local time. Null when there is none.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
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/maintenance-window \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "editable": true,
  "effective": {
    "end_hour": 4,
    "label": "00:00–04:00 UK time",
    "length_hours": 4,
    "source": "platform",
    "source_label": "Corefinity default",
    "staff_locked": false,
    "start_hour": 0,
    "timezone": "Europe/London"
  },
  "inherited": {
    "level": "platform",
    "name": "Corefinity default",
    "start_hour": 0
  },
  "next": {
    "ends_at": "2026-11-04T04:00:00Z",
    "hours": 4,
    "label": "00:00–04:00 UK time",
    "last_start_at": "2026-11-04T03:30:00Z",
    "local_date": "2026-11-04",
    "starts_at": "2026-11-04T00:00:00Z"
  },
  "notice_period": {
    "until": null
  },
  "own": null,
  "pending": {
    "count": 0,
    "notice": false
  },
  "site": {
    "domain": "harbourandfinch.example.com",
    "id": 1042
  },
  "snapshot_overlap": 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