Only the fields you send change, so extending a running window is { "endsAt": … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can’t be written directly.)
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. An org token sent with a header naming a different workspace is rejected 400 invalid_request. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sentivel","colors":{"primary":"#0a0a0a","light":"#fafafa","dark":"#0a0a0a"},"logo":{"light":"https://mintcdn.com/sentivel/v23hn2KMaKim_J85/logo/light.svg?fit=max\u0026auto=format\u0026n=v23hn2KMaKim_J85\u0026q=85\u0026s=d596fcea415e36d6f2d4ff8252abb1f7","dark":"https://mintcdn.com/sentivel/v23hn2KMaKim_J85/logo/dark.svg?fit=max\u0026auto=format\u0026n=v23hn2KMaKim_J85\u0026q=85\u0026s=0e37d4f65b18048afb8f1e4a91f3e5dd"},"favicon":"https://mintcdn.com/sentivel/v23hn2KMaKim_J85/favicon.svg?fit=max\u0026auto=format\u0026n=v23hn2KMaKim_J85\u0026q=85\u0026s=47a266fc98248bfb109dcb6e3088ceb2","appearance":{"default":"dark"},"background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"href":"mailto:support@sentivel.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.sentivel.com/dashboard"}},"footer":{"socials":{"website":"https://www.sentivel.com","github":"https://github.com/Sentivel"}},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sentivel","hasAudioNarration":false,"actualSubdomain":"sentivel","customDomains":["docs.sentivel.com"],"gitSource":{"type":"github","owner":"sentivel","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"b5d9c4d1-b0ad-435f-ba0c-4afb62f7a0b7","liveDeploymentHistoryId":"6adbce7961eb4581b7123ead","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbce7961eb4581b7123ead"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adbce7961eb4581b7123ead","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API reference","count":42},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Status pages","count":11},{"language":"default","tag":"Monitors","count":9},{"language":"default","tag":"Incidents","count":6},{"language":"default","tag":"Maintenance","count":5},{"language":"default","tag":"Monitoring \u0026 status","count":4},{"language":"default","tag":"Components","count":4},{"language":"default","tag":"Developers","count":3},{"language":"default","tag":"Incidents \u0026 on-call","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".nav-tabs-item[data-active=true],.nav-tabs-item[data-active=true] *,a[aria-current=location],a[aria-current=location] *,a[aria-current=page],a[aria-current=page] *{text-shadow:none!important;font-weight:450!important}h1{font-weight:520!important;letter-spacing:-.015em}h2,h3,h4{font-weight:500!important}"}],"page":{"pagePath":"api-reference/maintenance/update-or-move-a-maintenance-window","slug":"/api-reference/maintenance/update-or-move-a-maintenance-window","pageMetadata":{"title":"Update or move a maintenance window","description":"Only the fields you send change, so extending a running window is `{ \"endsAt\": … }` alone and the message it opened with survives. `status` is an action: `start` begins the window now, `complete` ends it now, and `cancel` calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can't be written directly.)","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /maintenance/{id}","href":"/api-reference/maintenance/update-or-move-a-maintenance-window","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Only the fields you send change, so extending a running window is \", _jsx(_components.code, {\n children: \"{ \\\"endsAt\\\": … }\"\n }), \" alone and the message it opened with survives. \", _jsx(_components.code, {\n children: \"status\"\n }), \" is an action: \", _jsx(_components.code, {\n children: \"start\"\n }), \" begins the window now, \", _jsx(_components.code, {\n children: \"complete\"\n }), \" ends it now, and \", _jsx(_components.code, {\n children: \"cancel\"\n }), \" calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can’t be written directly.)\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update or move a maintenance window","description":"Only the fields you send change, so extending a running window is `{ \"endsAt\": … }` alone and the message it opened with survives. `status` is an action: `start` begins the window now, `complete` ends it now, and `cancel` calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can't be written directly.)","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /maintenance/{id}","href":"/api-reference/maintenance/update-or-move-a-maintenance-window","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Maintenance"],"summary":"Update or move a maintenance window","description":"Only the fields you send change, so extending a running window is `{ \"endsAt\": … }` alone and the message it opened with survives. `status` is an action: `start` begins the window now, `complete` ends it now, and `cancel` calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can't be written directly.)","operationId":"updateMaintenance","parameters":["94e1ab44-75e1-4a21-b246-da3e382f48fe"],"requestBody":"7b6ff1ed-44a8-4738-8c2d-c5a417d2aa56","responses":{"200":"77281aa2-0286-45d7-b98f-518c8e84c7c0","400":"9913dec2-179b-42a6-8fa1-3ac6f2c9dd32","403":"4a029424-7930-4ea2-b21a-f1698a2a7867","404":"9b3a7239-343e-47f2-8588-7f75222decb4"},"method":"patch","type":"path","servers":["075f9e57-5727-459d-bd61-f58d41de58df"],"security":["eeef4821-43f6-4531-a9c9-a647e6207adf"],"path":"/maintenance/{id}","baseUrlOptions":["https://www.sentivel.com/api/v1"],"title":"Update or move a maintenance window","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"94e1ab44-75e1-4a21-b246-da3e382f48fe":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"All fields optional; only provided fields change.","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"title","typeLabel":"string"},"body":{"type":"string","maxLength":4000,"uniqueKey":"body","typeLabel":"string"},"startsAt":{"type":"string","format":"date-time","uniqueKey":"startsAt","typeLabel":"string\u003cdate-time>"},"endsAt":{"type":"string","format":"date-time","uniqueKey":"endsAt","typeLabel":"string\u003cdate-time>"},"componentIds":{"type":"array","maxItems":200,"items":{"type":"string","format":"uuid","uniqueKey":"componentIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"componentIds","typeLabel":"string\u003cuuid>[]"},"status":{"type":"string","enum":["start","complete","cancel"],"description":"`status` is an action: `start` begins the window now, `complete` ends it now, and `cancel` calls it off.","uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","body":"\u003cstring>","startsAt":"2023-11-07T05:31:56Z","endsAt":"2023-11-07T05:31:56Z","componentIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"77281aa2-0286-45d7-b98f-518c8e84c7c0":{"description":"The updated window.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","description":"The headline customers see.","uniqueKey":"data.title","typeLabel":"string"},"body":{"type":"string","description":"The public explanation.","uniqueKey":"data.body","typeLabel":"string"},"status":{"type":"string","enum":["scheduled","in_progress","completed","cancelled"],"description":"Where the window sits right now. Derived from the clock; only `cancelled` is a stored state.","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"startsAt":{"type":"string","format":"date-time","uniqueKey":"data.startsAt","typeLabel":"string\u003cdate-time>"},"endsAt":{"type":"string","format":"date-time","uniqueKey":"data.endsAt","typeLabel":"string\u003cdate-time>"},"components":{"type":"array","description":"Components the window affects. Empty = the whole workspace.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.components.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"data.components.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"data.components.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.components","typeLabel":"object[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","body":"\u003cstring>","status":"scheduled","startsAt":"2023-11-07T05:31:56Z","endsAt":"2023-11-07T05:31:56Z","components":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"9913dec2-179b-42a6-8fa1-3ac6f2c9dd32":{"description":"Nothing to change, or the resulting window is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","invalid_request","rate_limited","conflict","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"4a029424-7930-4ea2-b21a-f1698a2a7867":{"description":"The token's role can't manage status pages.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","invalid_request","rate_limited","conflict","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"9b3a7239-343e-47f2-8588-7f75222decb4":{"description":"No such maintenance window.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","invalid_request","rate_limited","conflict","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eeef4821-43f6-4531-a9c9-a647e6207adf":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Sent as `Authorization: Bearer \u003ctoken>`. 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`. An org token sent with a header naming a different workspace is rejected `400 invalid_request`. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"075f9e57-5727-459d-bd61-f58d41de58df":{"url":"https://www.sentivel.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Sent as `Authorization: Bearer \u003ctoken>`. 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`. An org token sent with a header naming a different workspace is rejected `400 invalid_request`. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Sent as `Authorization: Bearer \u003ctoken>`. 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`. An org token sent with a header naming a different workspace is rejected `400 invalid_request`. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://www.sentivel.com/api/v1/openapi.json"},"subdomain":"sentivel","siteName":"Sentivel","title":"Update or move a maintenance window - Sentivel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T23:43:55.802Z","originalFileLocation":"api-reference/maintenance/update-or-move-a-maintenance-window.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Only the fields you send change, so extending a running window is { \u0026quot;endsAt\u0026quot;: … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can\u0026#x27;t be written directly.)\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sentivel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update or move a maintenance window - Sentivel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Only the fields you send change, so extending a running window is { \u0026quot;endsAt\u0026quot;: … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can\u0026#x27;t be written directly.)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sentivel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sentivel.mintlify.app/_mintlify/api/og/v2?division=Maintenance\u0026amp;title=Update+or+move+a+maintenance+window\u0026amp;description=Only+the+fields+you+send+change%2C+so+extending+a+running+window+is+%60%7B+%22endsAt%22%3A+%E2%80%A6+%7D%60+alone+and+the+message+it+opened+with+survives.+%60status%60+is+an+action%3A+%60start\u0026amp;theme=04979a22682c09f042fefbde\u0026amp;signature=cfe904f4a1e23a93e6a5afb6913e93db5d733d366e6545f56408d53dbb156c11\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update or move a maintenance window - Sentivel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Only the fields you send change, so extending a running window is { \u0026quot;endsAt\u0026quot;: … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can\u0026#x27;t be written directly.)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sentivel.mintlify.app/_mintlify/api/og/v2?division=Maintenance\u0026amp;title=Update+or+move+a+maintenance+window\u0026amp;description=Only+the+fields+you+send+change%2C+so+extending+a+running+window+is+%60%7B+%22endsAt%22%3A+%E2%80%A6+%7D%60+alone+and+the+message+it+opened+with+survives.+%60status%60+is+an+action%3A+%60start\u0026amp;theme=04979a22682c09f042fefbde\u0026amp;signature=cfe904f4a1e23a93e6a5afb6913e93db5d733d366e6545f56408d53dbb156c11\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sentivel/wz6-x0HILtG4nmya/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sentivel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0a0a0a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/maintenance/update-or-move-a-maintenance-window.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sentivel.com/#organization\",\"name\":\"Sentivel\",\"url\":\"https://docs.sentivel.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sentivel/v23hn2KMaKim_J85/logo/light.svg?fit=max\u0026auto=format\u0026n=v23hn2KMaKim_J85\u0026q=85\u0026s=d596fcea415e36d6f2d4ff8252abb1f7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sentivel.com#website\",\"name\":\"Sentivel\",\"url\":\"https://docs.sentivel.com\",\"publisher\":{\"@id\":\"https://docs.sentivel.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window#webpage\",\"url\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window\",\"name\":\"Update or move a maintenance window\",\"description\":\"Only the fields you send change, so extending a running window is { \\\"endsAt\\\": … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can't be written directly.)\",\"dateModified\":\"2026-10-16T23:43:55.802Z\",\"isPartOf\":{\"@id\":\"https://docs.sentivel.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Maintenance\",\"item\":\"https://docs.sentivel.com/api-reference/maintenance/list-maintenance-windows\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update or move a maintenance window\",\"item\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window#apireference\",\"headline\":\"Update or move a maintenance window\",\"name\":\"Update or move a maintenance window\",\"description\":\"Only the fields you send change, so extending a running window is { \\\"endsAt\\\": … } alone and the message it opened with survives. status is an action: start begins the window now, complete ends it now, and cancel calls it off and keeps it on the public record. (The other phases are derived from the clock, so they can't be written directly.)\",\"url\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sentivel.com/api-reference/maintenance/update-or-move-a-maintenance-window#webpage\"},\"dateModified\":\"2026-10-16T23:43:55.802Z\",\"publisher\":{\"@id\":\"https://docs.sentivel.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sentivel.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sentivel\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sentivel","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","icon":"code","groups":[{"group":"Account","pages":[{"title":"Identify the calling token","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /me","href":"/api-reference/identity/identify-the-calling-token"}]},{"group":"Components","pages":[{"title":"List components","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /components","href":"/api-reference/components/list-components"},{"title":"Create a component","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /components","href":"/api-reference/components/create-a-component"},{"title":"Update a component","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /components/{id}","href":"/api-reference/components/update-a-component"},{"title":"Delete a component","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /components/{id}","href":"/api-reference/components/delete-a-component"}]},{"group":"Monitors","pages":[{"title":"List monitors","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /monitors","href":"/api-reference/monitors/list-monitors"},{"title":"Create a monitor","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /monitors","href":"/api-reference/monitors/create-a-monitor"},{"title":"Get a monitor","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /monitors/{id}","href":"/api-reference/monitors/get-a-monitor"},{"title":"Update a monitor","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /monitors/{id}","href":"/api-reference/monitors/update-a-monitor"},{"title":"Delete a monitor","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /monitors/{id}","href":"/api-reference/monitors/delete-a-monitor"},{"title":"Monitor uptime (90-day daily rollup)","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /monitors/{id}/uptime","href":"/api-reference/monitors/monitor-uptime-90-day-daily-rollup"},{"title":"Monitor response times (bucketed latency history)","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /monitors/{id}/response-times","href":"/api-reference/monitors/monitor-response-times-bucketed-latency-history"},{"title":"Start monitor maintenance","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /monitors/{id}/maintenance","href":"/api-reference/monitors/start-monitor-maintenance"},{"title":"End monitor maintenance","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /monitors/{id}/maintenance","href":"/api-reference/monitors/end-monitor-maintenance"}]},{"group":"Status pages","pages":[{"title":"List status pages","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /status-pages","href":"/api-reference/status-pages/list-status-pages"},{"title":"Create a status page","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /status-pages","href":"/api-reference/status-pages/create-a-status-page"},{"title":"Update a status page","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /status-pages/{id}","href":"/api-reference/status-pages/update-a-status-page"},{"title":"Delete a status page","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /status-pages/{id}","href":"/api-reference/status-pages/delete-a-status-page"},{"title":"Get a status page's layout","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /status-pages/{id}/layout","href":"/api-reference/status-pages/get-a-status-pages-layout"},{"title":"Replace a status page's layout","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json put /status-pages/{id}/layout","href":"/api-reference/status-pages/replace-a-status-pages-layout"},{"title":"Set a status page's logo","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json put /status-pages/{id}/logo","href":"/api-reference/status-pages/set-a-status-pages-logo"},{"title":"Remove a status page's logo","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /status-pages/{id}/logo","href":"/api-reference/status-pages/remove-a-status-pages-logo"},{"title":"Set a status page's custom domain","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json put /status-pages/{id}/custom-domain","href":"/api-reference/status-pages/set-a-status-pages-custom-domain"},{"title":"Verify a status page's custom domain","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /status-pages/{id}/custom-domain/verify","href":"/api-reference/status-pages/verify-a-status-pages-custom-domain"},{"title":"Remove a status page's custom domain","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /status-pages/{id}/custom-domain","href":"/api-reference/status-pages/remove-a-status-pages-custom-domain"}]},{"group":"Maintenance","pages":[{"title":"List maintenance windows","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /maintenance","href":"/api-reference/maintenance/list-maintenance-windows"},{"title":"Schedule a maintenance window","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /maintenance","href":"/api-reference/maintenance/schedule-a-maintenance-window"},{"title":"Get a maintenance window","description":"One window: its title, public message, time range, current phase, and affected components.","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /maintenance/{id}","href":"/api-reference/maintenance/get-a-maintenance-window"},{"title":"Update or move a maintenance window","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /maintenance/{id}","href":"/api-reference/maintenance/update-or-move-a-maintenance-window"},{"title":"Delete a maintenance window","description":"Remove the window entirely. To call one off but keep it on the public record, PATCH `status: \"cancel\"` instead.","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /maintenance/{id}","href":"/api-reference/maintenance/delete-a-maintenance-window"}]},{"group":"Incidents","pages":[{"title":"List incidents","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /incidents","href":"/api-reference/incidents/list-incidents"},{"title":"Create a manual incident","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json post /incidents","href":"/api-reference/incidents/create-a-manual-incident"},{"title":"Get an incident","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /incidents/{id}","href":"/api-reference/incidents/get-an-incident"},{"title":"Delete an incident","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json delete /incidents/{id}","href":"/api-reference/incidents/delete-an-incident"},{"title":"Get an incident's update timeline","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /incidents/{id}/updates","href":"/api-reference/incidents/get-an-incidents-update-timeline"},{"title":"Get an incident's live escalation state","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /incidents/{id}/escalation","href":"/api-reference/incidents/get-an-incidents-live-escalation-state"}]},{"group":"On-call","pages":[{"title":"List on-call schedules","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /schedules","href":"/api-reference/on-call/list-on-call-schedules"},{"title":"Get an on-call schedule","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /schedules/{id}","href":"/api-reference/on-call/get-an-on-call-schedule"}]},{"group":"Integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /integrations","href":"/api-reference/integrations/list-integrations"},{"title":"Get an integration","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /integrations/{id}","href":"/api-reference/integrations/get-an-integration"},{"title":"Update an outbound integration","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json patch /integrations/{id}","href":"/api-reference/integrations/update-an-outbound-integration"}]},{"group":"Members","pages":[{"title":"List workspace members","deprecated":null,"version":null,"openapi":"https://www.sentivel.com/api/v1/openapi.json get /members","href":"/api-reference/people/list-workspace-members"}]}]}]},"basePath":"","title":"Update or move a maintenance window - Sentivel","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}