---
title: "Update your company's maintenance window"
url: https://docs.corefinity.com/api/reference/site-settings/update-company-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 your company's maintenance window

Sets the default window for every site and CoreCluster of your company that has none of its own. Changes already queued for them move to the new window.

```http
PUT /api/company/maintenance-window
```

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

## 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/company/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/company/maintenance-window', [
        'start_hour' => 3,
    ]);

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

### Node

```javascript
const res = await fetch('https://manage.corefinity.com/api/company/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/company/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
{
  "company": {
    "id": 1204,
    "name": "Harbour & Finch"
  },
  "editable": true,
  "effective": {
    "end_hour": 7,
    "label": "03:00–07:00 UK time",
    "length_hours": 4,
    "source": "company",
    "source_label": "Company default",
    "staff_locked": false,
    "start_hour": 3,
    "timezone": "Europe/London"
  },
  "inherited": {
    "level": "platform",
    "name": "Corefinity default",
    "start_hour": 0
  },
  "own": {
    "start_hour": 3
  },
  "reach": {
    "clusters": 1,
    "sites": 1
  },
  "restamped": 0
}
```

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

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

### 403 The token lacks the `write` scope (`scope_required`), or your company requires two-factor authentication and you have not set it up.

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

### 404 The id does not exist or is something you cannot see, or the feature is not on for your company (`feature_off`).

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

### 422 The start hour is missing or wrong.

```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 | `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 | `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)
