---
title: "Update a CoreCluster's maintenance window"
url: https://docs.corefinity.com/api/reference/site-settings/update-cluster-maintenance-window
type: endpoint
last_updated: 2026-11-13
feature: maintenance-windows
related:
  - https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md
---
# Update a CoreCluster's maintenance window

Sets the default window of the CoreCluster, used by every site in it that has none of its own. Changes already queued for those sites move to the new window.

```http
PUT /api/coreclusters/{cluster}/maintenance-window
```

- Scope: `write`
- Two-factor: required on your account (all)
- Rate limit: 60 a minute; 10 an hour for each cluster; 30 an hour for each person
- Try it in the console: on

## Path parameters

- `cluster` (integer, required): The id of a CoreCluster. Digits only.

## Body

- `start_hour` (integer, required): The hour the window opens, from 0 to 23, UK time.

## Request

### curl

```bash
curl -X PUT https://manage.corefinity.com/api/coreclusters/1017/maintenance-window \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "start_hour": 3
  }'
```

### PHP

```php
use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('COREFINITY_TOKEN'))
    ->acceptJson()
    ->put('https://manage.corefinity.com/api/coreclusters/1017/maintenance-window', [
        'start_hour' => 3,
    ]);

$data = $response->json();
```

### Node

```javascript
const res = await fetch('https://manage.corefinity.com/api/coreclusters/1017/maintenance-window', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    start_hour: 3,
  }),
});

// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);
```

### Python

```python
import os
import requests

res = requests.put(
    "https://manage.corefinity.com/api/coreclusters/1017/maintenance-window",
    headers={
        "Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
        "Accept": "application/json",
    },
    json={
        "start_hour": 3,
    },
)

data = res.json() if res.content else None
```

## Responses

### 200 The window was saved. `restamped` counts the queued changes that moved.

```json
{
  "cluster": {
    "id": 1017,
    "name": "Northwind UK 1"
  },
  "editable": true,
  "effective": {
    "end_hour": 7,
    "label": "03:00–07:00 UK time",
    "length_hours": 4,
    "source": "cluster",
    "source_label": "CoreCluster default",
    "staff_locked": false,
    "start_hour": 3,
    "timezone": "Europe/London"
  },
  "inherited": {
    "level": "platform",
    "name": "Corefinity default",
    "start_hour": 0
  },
  "overrides": {
    "count": 0,
    "sites": []
  },
  "own": {
    "start_hour": 3
  },
  "restamped": 0
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the `write` scope (`scope_required`), your company requires two-factor authentication and you have not set it up, or you can see this but may not change it (`forbidden`; today everyone who can see it may change its window, so this is not answered yet).

```json
{
  "code": "company_unavailable",
  "message": "Your company is unavailable.",
  "reason": "company_unavailable"
}
```

### 404 The cluster does not exist or is not a CoreCluster of your company (both answer the same body; shared hosting has no window of its own at this level), or maintenance windows are not on for the API (`feature_off`).

```json
{
  "code": "feature_off",
  "message": "Not found.",
  "reason": "feature_off"
}
```

### 409 Corefinity has set the window, so it cannot be changed here.

```json
{
  "code": "window_locked",
  "message": "This CoreCluster's window is set by Corefinity.",
  "reason": "window_locked"
}
```

### 422 The start hour is missing or wrong (`window_start_invalid`).

```json
{
  "code": "window_start_invalid",
  "message": "Choose a start hour from 00 to 23.",
  "reason": "window_start_invalid"
}
```

### 429 Too many requests (`rate_limited`, with `Retry-After`), or too many window changes in the last hour (`throttled`): ten for one site, CoreCluster or company, thirty for one person, counted with the Control Panel and AI assistants. Both answers carry `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many requests. Try again in 60 seconds.",
  "reason": "rate_limited",
  "retry_after_seconds": 60
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | Send a valid token as `Authorization: Bearer <token>`. |
| 403 | `company_unavailable` | Your company is unavailable. |
| 403 | `forbidden` | The person is not allowed to do this. |
| 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. |
| 409 | `window_locked` | The maintenance window is set by Corefinity. Contact support to change it. |
| 422 | `window_start_invalid` | The start hour is not one. Choose an hour from 00 to 23. |
| 429 | `rate_limited` | Wait for the seconds in `Retry-After`. |
| 429 | `throttled` | Too many tries. Wait a minute and try again. |

## The same task elsewhere

- Guide: [Maintenance window](https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md)
