Skip to main content
POST
Schedule a maintenance window

Authorizations

Authorization
string
header
required

Sent as Authorization: Bearer <token>. Three kinds are accepted: an ORG token (sv_…), bound to one workspace with a fixed role; a PERSONAL token (svu_…), which acts as you with your own live role in whichever workspace it is pointed at; and an OAUTH access token (mcp_at_…) from a connected app, limited to the workspaces you granted it. A personal or OAuth token names its workspace with the X-Sentivel-Workspace header (a slug or an id). Without it an OAuth token falls back to the connection's primary workspace, while a personal token in more than one workspace is rejected 400 invalid_request with the choices in error.details.workspaces. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.

Body

application/json
title
string
required
Required string length: 1 - 200
startsAt
string<date-time>
required

ISO 8601 with an offset, e.g. 2026-09-01T22:00:00Z.

endsAt
string<date-time>
required
body
string
Maximum string length: 4000
componentIds
string<uuid>[]

Omit or leave empty to mean the whole workspace.

Maximum array length: 200

Response

The scheduled window.

data
object