Skip to main content
PATCH
Update or move 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.

Path Parameters

id
string<uuid>
required

Body

application/json

All fields optional; only provided fields change.

title
string
Required string length: 1 - 200
body
string
Maximum string length: 4000
startsAt
string<date-time>
endsAt
string<date-time>
componentIds
string<uuid>[]
Maximum array length: 200
status
enum<string>

An action, not a state: begin the window now, end it now, or call it off.

Available options:
start,
complete,
cancel

Response

The updated window.

data
object