The policy in effect (the monitor’s own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.
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/incidents/get-an-incidents-live-escalation-state","slug":"/api-reference/incidents/get-an-incidents-live-escalation-state","pageMetadata":{"title":"Get an incident's live escalation state","description":"The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The policy in effect (the monitor’s own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\"\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":"Get an incident's live escalation state","description":"The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Incidents"],"summary":"Get an incident's live escalation state","description":"The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.","operationId":"getIncidentEscalation","parameters":["7f38c816-e7f0-4d55-a358-960081b260b5"],"responses":{"200":"b1f3f85e-1575-4df0-bb53-e16cb0e0b5eb","404":"d07d37bc-5622-41bb-a381-e7f14b9284a4"},"method":"get","type":"path","servers":["075f9e57-5727-459d-bd61-f58d41de58df"],"security":["eeef4821-43f6-4531-a9c9-a647e6207adf"],"path":"/incidents/{id}/escalation","baseUrlOptions":["https://www.sentivel.com/api/v1"],"title":"Get an incident's live escalation state","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7f38c816-e7f0-4d55-a358-960081b260b5":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"b1f3f85e-1575-4df0-bb53-e16cb0e0b5eb":{"description":"The incident's escalation state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"incidentId":{"type":"string","format":"uuid","uniqueKey":"data.incidentId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","uniqueKey":"data.status","typeLabel":"string"},"acknowledgedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.acknowledgedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.acknowledgedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.acknowledgedAt","typeLabel":"string\u003cdate-time> | null"},"resolvedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.resolvedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.resolvedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.resolvedAt","typeLabel":"string\u003cdate-time> | null"},"escalating":{"type":"boolean","description":"True while escalation is still active (open + unacknowledged).","uniqueKey":"data.escalating","typeLabel":"boolean"},"elapsedMinutes":{"type":"integer","uniqueKey":"data.elapsedMinutes","typeLabel":"integer"},"policy":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.policy.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"data.policy.oneOf.0.name","typeLabel":"string"},"repeatCount":{"type":"integer","uniqueKey":"data.policy.oneOf.0.repeatCount","typeLabel":"integer"},"silent":{"type":"boolean","description":"Silent triage policy: records incidents but pages no one (no steps fire).","uniqueKey":"data.policy.oneOf.0.silent","typeLabel":"boolean"},"runbook":{"oneOf":[{"type":"string","description":"The policy's responder runbook (markdown checklist/playbook), or null if none.","uniqueKey":"data.policy.oneOf.0.runbook.oneOf.0","typeLabel":"string"},{"type":"null","description":"The policy's responder runbook (markdown checklist/playbook), or null if none.","uniqueKey":"data.policy.oneOf.0.runbook.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.policy.oneOf.0.runbook","typeLabel":"string | null"}},"uniqueKey":"data.policy.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"repeatCount":{"type":"integer"},"silent":{"type":"boolean","description":"Silent triage policy: records incidents but pages no one (no steps fire)."},"runbook":{"oneOf":[{"type":"string","description":"The policy's responder runbook (markdown checklist/playbook), or null if none."},{"type":"null","description":"The policy's responder runbook (markdown checklist/playbook), or null if none."}]}},"uniqueKey":"data.policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.policy","typeLabel":"object | null"},"steps":{"type":"array","items":{"type":"object","properties":{"stepId":{"type":"string","format":"uuid","uniqueKey":"data.steps.items.[INDEX].stepId","typeLabel":"string\u003cuuid>"},"position":{"type":"integer","uniqueKey":"data.steps.items.[INDEX].position","typeLabel":"integer"},"delayMinutes":{"type":"integer","uniqueKey":"data.steps.items.[INDEX].delayMinutes","typeLabel":"integer"},"minImpact":{"type":"string","uniqueKey":"data.steps.items.[INDEX].minImpact","typeLabel":"string"},"due":{"type":"boolean","uniqueKey":"data.steps.items.[INDEX].due","typeLabel":"boolean"},"fired":{"type":"boolean","uniqueKey":"data.steps.items.[INDEX].fired","typeLabel":"boolean"},"firedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.steps.items.[INDEX].firedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.steps.items.[INDEX].firedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.steps.items.[INDEX].firedAt","typeLabel":"string\u003cdate-time> | null"},"deliveries":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].channel","typeLabel":"string"},"target":{"type":"string","uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].target","typeLabel":"string"},"status":{"type":"string","uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].status","typeLabel":"string"},"sentAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].sentAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].sentAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX].sentAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.steps.items.[INDEX].deliveries.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.steps.items.[INDEX].deliveries","typeLabel":"object[]"}},"uniqueKey":"data.steps.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.steps","typeLabel":"object[]"},"note":{"type":"string","description":"Present when no ladder applies (no policy).","uniqueKey":"data.note","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"incidentId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"\u003cstring>","acknowledgedAt":"2023-11-07T05:31:56Z","resolvedAt":"2023-11-07T05:31:56Z","escalating":true,"elapsedMinutes":123,"policy":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","repeatCount":123,"silent":true,"runbook":"\u003cstring>"},"steps":[{"stepId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","position":123,"delayMinutes":123,"minImpact":"\u003cstring>","due":true,"fired":true,"firedAt":"2023-11-07T05:31:56Z","deliveries":[{"channel":"\u003cstring>","target":"\u003cstring>","status":"\u003cstring>","sentAt":"2023-11-07T05:31:56Z"}]}],"note":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d07d37bc-5622-41bb-a381-e7f14b9284a4":{"description":"No such incident.","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":"Get an incident's live escalation state - Sentivel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T23:43:55.888Z","originalFileLocation":"api-reference/incidents/get-an-incidents-live-escalation-state.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=\"The policy in effect (the monitor\u0026#x27;s own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\">\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=\"Get an incident\u0026#x27;s live escalation state - Sentivel\">\u003cmeta data-mint-head property=\"og:description\" content=\"The policy in effect (the monitor\u0026#x27;s own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sentivel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state\">\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=Incidents\u0026amp;title=Get+an+incident%27s+live+escalation+state\u0026amp;description=The+policy+in+effect+%28the+monitor%27s+own%2C+else+the+workspace+default%29%2C+each+ladder+step%2C+which+steps+have+already+paged+%28and+via+what+delivery%29%2C+and+whether+the+\u0026amp;theme=04979a22682c09f042fefbde\u0026amp;signature=eb17f63547b558d63106404377acee343e72720bd35789c73359bbef897a8879\">\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=\"Get an incident\u0026#x27;s live escalation state - Sentivel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The policy in effect (the monitor\u0026#x27;s own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sentivel.mintlify.app/_mintlify/api/og/v2?division=Incidents\u0026amp;title=Get+an+incident%27s+live+escalation+state\u0026amp;description=The+policy+in+effect+%28the+monitor%27s+own%2C+else+the+workspace+default%29%2C+each+ladder+step%2C+which+steps+have+already+paged+%28and+via+what+delivery%29%2C+and+whether+the+\u0026amp;theme=04979a22682c09f042fefbde\u0026amp;signature=eb17f63547b558d63106404377acee343e72720bd35789c73359bbef897a8879\">\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/incidents/get-an-incidents-live-escalation-state\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/incidents/get-an-incidents-live-escalation-state.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/incidents/get-an-incidents-live-escalation-state#webpage\",\"url\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state\",\"name\":\"Get an incident's live escalation state\",\"description\":\"The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\",\"dateModified\":\"2026-10-16T23:43:55.888Z\",\"isPartOf\":{\"@id\":\"https://docs.sentivel.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Incidents\",\"item\":\"https://docs.sentivel.com/api-reference/incidents/list-incidents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an incident's live escalation state\",\"item\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state#apireference\",\"headline\":\"Get an incident's live escalation state\",\"name\":\"Get an incident's live escalation state\",\"description\":\"The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.\",\"url\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sentivel.com/api-reference/incidents/get-an-incidents-live-escalation-state#webpage\"},\"dateModified\":\"2026-10-16T23:43:55.888Z\",\"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","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","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","description":"The chronological update history posted to one incident (oldest first): each update's status, message, author, and time.","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","description":"The workspace's on-call schedules, each with who is on call right now, the next handoff time, the rotation cadence, and the participants.","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":"Get an incident's live escalation state - 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"]}