> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dark Windows

> Pause proactive outbound activity per channel during quiet hours.

Dark Windows are available under **Settings → Data → Dark Windows**. They let
workspace owners and admins pause proactive outbound activity for individual
channels without turning the channel off.

## How a window works

Each channel has its own on/off switch, start time, and end time. Times use the
workspace timezone shown on the page. The start is included and the end is
excluded. A window such as `21:00` to `08:00` runs overnight.

Dark Windows apply to proactive sends and dials from campaigns, callbacks,
automations, the API, and MCP. Replies to inbound customer messages and manual
replies from History remain available.

## Channels

You can configure separate windows for Voice, SMS, Email, WhatsApp, Telegram,
Slack, Messenger, Microsoft Teams, Discord, Google Chat, and X.

Workspaces that opt into beta features also see separate controls for
Freshdesk, Gmail, Outlook, Zendesk, ServiceNow, Intercom, Zoho Mail, AgentMail,
Instagram, and Zulip. The generic Email window and the provider-specific email
windows are independent.

## API and MCP

* `GET /api/v1/settings/dark-windows` returns all channel windows and the
  workspace timezone.
* `PATCH /api/v1/settings/dark-windows` updates one or more channels. Channels
  omitted from `settings` remain unchanged.
* MCP tools: `get_dark_window_settings` and `update_dark_window_settings`.

REST uses `settings:read` / `settings:write`; MCP also accepts the matching
assistant read/write scopes.

```json theme={null}
{
  "settings": {
    "gmail": { "enabled": true, "start": "21:00", "end": "08:00" },
    "outlook": { "enabled": true, "start": "22:00", "end": "07:00" }
  }
}
```
