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

Delete a CoreCluster's maintenance window

Deletes the CoreCluster's own default, so its sites that have no window of their own use your company's default again, else Corefinity's. Changes already queued move with it.

DELETE/api/coreclusters/{cluster}/maintenance-window

Path parameters

clusterintegerRequired

The id of a CoreCluster. Digits only. At least 1.

Returns

200 The window the CoreCluster uses now.

Fields of the 200 answer
clusterobjectRequired

A cluster by its id and name. A standalone CoreStack site reads CoreStack as the name.

Fields
idintegerRequired
namestringRequired
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.

overridesobjectRequired

The sites of the CoreCluster that have a window of their own.

Fields
countintegerRequired
sitesarray of objectsRequired
Fields of each item
domainstringRequired
idintegerRequired

At least 1.

start_hourintegerRequired

0 to 23.

ownobject or any or nullRequired

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

restampedinteger

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

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403forbiddenThe person is not allowed to do this.
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.
409window_lockedThe maintenance window is set by Corefinity. Contact support to change it.
429rate_limitedWait for the seconds in Retry-After.
429throttledToo many tries. Wait a minute and try again.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X DELETE https://manage.corefinity.com/api/coreclusters/1017/maintenance-window \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "cluster": {
    "id": 1017,
    "name": "Northwind UK 1"
  },
  "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
  },
  "overrides": {
    "count": 0,
    "sites": []
  },
  "own": null,
  "restamped": 0
}
Try it

Try it is off for this endpointIt deletes data that cannot be brought back. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT