---
title: "corestack_company_maintenance_window_set"
url: https://docs.corefinity.com/mcp/tools/corestack_company_maintenance_window_set
type: tool
last_updated: 2026-11-13
feature: maintenance-windows
related:
  - https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md
---
# corestack_company_maintenance_window_set

**Set the company maintenance window.** Sets your company's default maintenance window, used by every site and cluster without its own. Answers the new window and restamped. Scope: write.

- Scope: `write`
- Runs as a task: no

## When to use it

Set your company's default maintenance window: it applies to every site and CoreCluster without its own. Company-wide: a token limited to some sites gets `pin_refused` (ask for one that works everywhere in your company).

## Inputs

- `start_hour` (integer 0–23, required).

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "start_hour": {
      "description": "The hour the 4-hour window starts, UK time (0–23).",
      "maximum": 23,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "start_hour"
  ],
  "type": "object"
}
```

## Refusals

- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).
- `window_locked`: Corefinity set this window (it cannot be changed here; ask support).
- `throttled`: too many window changes in the last hour; try again later (`retry_after_seconds` when known).

## Example

```json
{
  "name": "corestack_company_maintenance_window_set",
  "arguments": {
    "start_hour": 2
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_maintenance_window_set with start_hour 2. (Set the company maintenance window.) Tell me what it returned.
```

## The same task elsewhere

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