{"components":{"securitySchemes":{"ApiKeyAuth":{"in":"header","name":"X-OpsPing-Key","type":"apiKey"},"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"CookieAuth":{"in":"cookie","name":"__Host-token","type":"apiKey"},"MeetingBotSessionAuth":{"bearerFormat":"MeetingBotSessionToken","scheme":"bearer","type":"http"},"ReleaseHMAC":{"description":"HMAC-SHA256 request signature (`v1=\u003chex\u003e`). The companion timestamp and nonce headers are part of the signed canonical string.","in":"header","name":"X-OpsPing-Release-Signature","type":"apiKey"},"ZoomConnectToken":{"in":"query","name":"token","type":"apiKey"}}},"info":{"description":"OpsPing on-call platform API. Alert ingest accepts JSON and pages through escalation policies; everything else is CRUD over your tenant's resources. Auth: API key (X-OpsPing-Key / OpsPingKey / Bearer) or JWT bearer — admin-session-only routes are not documented in this public spec. Errors use a uniform envelope `{code, message, requestId, took}`.","title":"OpsPing API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/health":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Liveness probe (`?deep=1` adds the database check)","tags":["General"]}},"/health/paging":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Paging-path probe (core worker liveness + rolling delivery-failure guard)","tags":["General"]}},"/health/paging/detail":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Authenticated paging-path diagnostics","tags":["General"]}},"/health/writable":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Read-write probe (traffic-steering gate; 503 while Postgres is in recovery or unreachable)","tags":["General"]}},"/v2/access-attestations":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List eligibility attestations as a designated verifier","tags":["Incident Access"]}},"/v2/access-attestations/{userId}/{attribute}":{"delete":{"parameters":[{"in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{reason,reference}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Revoke an attestation immediately","tags":["Incident Access"]},"put":{"parameters":[{"in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{value:{kind:boolean|string,bool?,text?},expiresAt,reason,reference}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Independently attest another user's eligibility with reason, reference and expiry","tags":["Incident Access"]}},"/v2/access-policies":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"attestationAvailable":{"type":"boolean"},"attestationExplanation":{"type":"string"},"authoringEnabled":{"description":"Whether the durable erasure-aware compatibility floor permits feature authoring. Independent of execution, classification, attester and provider readiness; absent or unknown means closed.","type":"boolean"},"classificationEnabled":{"type":"boolean"},"data":{"items":{"type":"object"},"type":"array"}},"required":["authoringEnabled"],"type":"object"}}},"description":"Authorized metadata; no operator cross-tenant inventory is exposed."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List tenant access policies and current activation/verifier availability","tags":["Incident Access"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{name, requirements:[{attribute,operator:eq|in,values:[{kind:boolean|string,bool?,text?}]}]}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an AND-based typed eligibility policy","tags":["Incident Access"]}},"/v2/access-policies/audit":{"get":{"parameters":[{"description":"Sequence cursor; returns at most 1000 records.","in":"query","name":"after","required":false,"schema":{"minimum":0,"type":"integer"}},{"description":"Optional CSV export; otherwise JSON.","in":"query","name":"format","required":false,"schema":{"enum":["csv"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read chained restriction audit records","tags":["Incident Access"]}},"/v2/access-policies/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read a tenant policy definition","tags":["Incident Access"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rename or tighten a policy without removing inherited requirements","tags":["Incident Access"]}},"/v2/account":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Account summary (effective plan, counts and billing state)","tags":["General"]}},"/v2/account/billing":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{plan, billing, offers, voice, policy}`. offers are public list prices only (legacy grandfathered prices never appear). Legacy voice fields are derived from shared estimated provider spend, not actual call duration; customer quota meters are not shown. Paid budgets are soft; trial/PoC evaluation caps remain hard."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Billing summary: public offers (team/business × monthly/annual), current interval, legacy/grandfathered status and switcher-offer eligibility","tags":["Billing"]}},"/v2/alert-policies":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List alert policies (evaluation order)","tags":["Alerts"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Policy fields (conditions, actions incl. runbookUrl, order)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an alert policy","tags":["Alerts"]}},"/v2/alert-policies/dry-run":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"A sample alert payload","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Dry-run a policy chain against an alert","tags":["Alerts"]}},"/v2/alert-policies/reorder":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{ids}` — policies in the new order","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reorder policies","tags":["Alerts"]}},"/v2/alert-policies/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an alert policy","tags":["Alerts"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one alert policy","tags":["Alerts"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Policy fields to change (actions may set runbookUrl)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update an alert policy","tags":["Alerts"]}},"/v2/alerts":{"get":{"parameters":[{"description":"Rows per flat page. Non-numeric or zero uses 20; values above 100 clamp to 100; fractional values round up and negative values yield one row.","in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"type":"number"}},{"description":"Opaque `nextCursor` from the previous flat page. Invalid values return `PAGINATION_CURSOR_INVALID`; not supported with `groupBy`.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Case-insensitive substring search across message, description, source, and tags. Opsgenie-style field tokens are extracted first: `alias:\u003cvalue\u003e` (exact, case-sensitive; double-quote values with spaces) and `status:\u003cvalue\u003e` (equivalent to the status parameter, which wins on conflict).","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Exact status filter; unsupported values return 400 VALIDATION.","in":"query","name":"status","required":false,"schema":{"enum":["open","acknowledged","snoozed","closed"],"type":"string"}},{"description":"Exact alert priority.","in":"query","name":"priority","required":false,"schema":{"enum":["P1","P2","P3","P4","P5"],"type":"string"}},{"description":"Exact integration/source name.","in":"query","name":"source","required":false,"schema":{"type":"string"}},{"description":"Admin NOC view across every team in the tenant. Other callers remain limited by list scope.","in":"query","name":"allTeams","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return groups instead of a flat page. Grouped reads do not accept `cursor` and do not return `nextCursor`.","in":"query","name":"groupBy","required":false,"schema":{"enum":["service","source","priority"],"type":"string"}},{"description":"`mine` includes direct ownership and user/team responder assignments; `unassigned` requires no owner.","in":"query","name":"assignment","required":false,"schema":{"enum":["mine","unassigned"],"type":"string"}},{"description":"Restrict results to active alerts (`open` or `acknowledged`).","in":"query","name":"active","required":false,"schema":{"enum":["true"],"type":"string"}},{"description":"Walk the keyset oldest-first (`created_at ASC, id ASC`) so pages advance from the oldest matching alert; the default walks newest-first. `nextCursor` values are direction-tagged — passing a cursor under the other direction returns `PAGINATION_CURSOR_INVALID`.","in":"query","name":"order","required":false,"schema":{"enum":["oldest"],"type":"string"}},{"description":"Explicitly include drill alerts in this queue view; production reports remain drill-free.","in":"query","name":"includeDrills","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List alerts (tenant/team scoped, searchable, filterable, cursor-paginated)","tags":["Alerts"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Alert payload (message, entity/service, priority, responders, details, tags, runbookUrl, optional stable recurrenceKey, …)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an alert (the paging ingest endpoint)","tags":["Alerts"]}},"/v2/alerts/bulk":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{ids, action, …}`","required":true},"responses":{"200":{"description":"Per-item outcomes; blocked drill authoring returns error FEATURE_AUTHORING_UNAVAILABLE without preventing ordinary alert items from completing."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Bulk ack/close/snooze/assign","tags":["Alerts"]}},"/v2/alerts/count":{"get":{"parameters":[{"description":"Same syntax as GET /v2/alerts: `alias:\u003cvalue\u003e` (exact, case-sensitive) and `status:\u003cvalue\u003e` tokens are extracted first; the rest is a case-insensitive substring search across message, description, source, and tags.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data: {count}, took, requestId}. Any query parameter other than `query` returns 400 VALIDATION."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Alert count in the rolling window","tags":["Alerts"]}},"/v2/alerts/counts":{"get":{"parameters":[{"description":"Case-insensitive substring search across message, description, source, and tags; `alias:\u003cvalue\u003e` and `status:\u003cvalue\u003e` tokens are extracted first (see GET /v2/alerts).","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Exact alert priority.","in":"query","name":"priority","required":false,"schema":{"enum":["P1","P2","P3","P4","P5"],"type":"string"}},{"description":"Exact integration/source name. The `sources` facet still includes alternatives in the remaining scope.","in":"query","name":"source","required":false,"schema":{"type":"string"}},{"description":"Ownership view.","in":"query","name":"assignment","required":false,"schema":{"enum":["mine","unassigned"],"type":"string"}},{"description":"Restrict facets to open or acknowledged work.","in":"query","name":"active","required":false,"schema":{"enum":["true"],"type":"string"}},{"description":"Admin NOC view across every team in the tenant. Other callers remain limited by list scope.","in":"query","name":"allTeams","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Explicitly include drill alerts in this queue view; production reports remain drill-free.","in":"query","name":"includeDrills","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data: {all, open, acknowledged, snoozed, closed, sources}, took, requestId}. Status, cursor, limit, and groupBy are list-only and return 400 VALIDATION."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Exact full-history status counts within the alert list access/search scope","tags":["Alerts"]}},"/v2/alerts/summary":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Dashboard aggregate counts","tags":["Alerts"]}},"/v2/alerts/{identifier}":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an alert","tags":["Alerts"]},"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one alert (with notes + activity)","tags":["Alerts"]}},"/v2/alerts/{identifier}/acknowledge":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current occurrence inside the caller's tenant; otherwise native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"202":{"description":"Acknowledged (idempotent)."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Alert not found in the caller's tenant."},"409":{"description":"Cannot acknowledge a closed alert."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Acknowledge","tags":["Alerts"]}},"/v2/alerts/{identifier}/activities":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Opt into a bounded recent activity page (default 50, maximum 200). Invalid or non-positive values use the default.","in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"description":"Opaque data.nextCursor from the preceding page of this alert. Exclusive newest-first keyset; malformed, empty or cross-alert cursors return 400 PAGINATION_CURSOR_INVALID. Omit to start a fresh recent window.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Newest-first `{data:{activities:[...],nextCursor?},took,requestId}`. With neither limit nor cursor, returns the complete legacy history without nextCursor. Paging is opt-in and SQL-bounded; notes remain available independently from GET /notes."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the alert's activity log","tags":["Alerts"]}},"/v2/alerts/{identifier}/assign":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Un-assign the current owner","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Native `{userId?, user?, note?}` (no target takes ownership), or Opsgenie `{\"owner\":{\"id\":\"OpsPing user ID\"}}` / `{\"owner\":{\"username\":\"email\"}}`, with optional user/source/note. With owner, user is actor attribution, not the target; authenticated identity takes precedence. Both owner.id/username must identify the same tenant user; a supplied native userId must agree. Invalid/missing/foreign owners never take ownership.","required":false},"responses":{"202":{"description":"Assigned."},"400":{"description":"Invalid, missing, foreign or conflicting target; no mutation."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Cannot assign a closed alert."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Assign an owner","tags":["Alerts"]}},"/v2/alerts/{identifier}/attachments":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the alert's attachments","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Attach a file (S3-backed)","tags":["Alerts"]}},"/v2/alerts/{identifier}/attachments/{attachmentId}":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"in":"path","name":"attachmentId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an attachment","tags":["Alerts"]}},"/v2/alerts/{identifier}/attachments/{attachmentId}/complete":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"in":"path","name":"attachmentId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Complete a multipart attachment upload","tags":["Alerts"]}},"/v2/alerts/{identifier}/bridge-runs":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List signed bridge runs linked to an alert","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{integrationId, idempotencyKey, operation, action?, parameters?}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Run an allowlisted signed action or enrichment bridge","tags":["Alerts"]}},"/v2/alerts/{identifier}/changes":{"get":{"parameters":[{"description":"Alert id, numeric tiny-id, or alias (see the alerts routes).","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{state, lookbackMinutes, changes:[…]}` in the standard envelope. `state` is `ok|unconfigured|no_service|unmapped`, so a tenant that has not wired a provider reads as `unconfigured` rather than an empty list. Correlates on the alert's `serviceId` with the alert's `createdAt` as the window start."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List deployment changes correlated to an alert's service","tags":["Deployments"]}},"/v2/alerts/{identifier}/close":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or newest closed occurrence for an idempotent retry. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"202":{"description":"Closed (idempotent)."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Alert not found in the caller's tenant."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Close","tags":["Alerts"]}},"/v2/alerts/{identifier}/deliveries":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Provider acceptance and app-generated received/opened/actioned timestamps; a missing app receipt is uncertain delivery, not proof of failure"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List per-device push delivery evidence for an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/details":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{details}` — key/value pairs to add","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Merge extra key/value details into the alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/escalate":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Optional `{\"escalation\":{\"id\":\"OpsPing policy ID\"}}`, with user/source/note accepted. The selector must name the alert's current policy (state pin, alert pin, or normal policy selection). Policy names and retargeting to another policy are not supported. An absent body preserves native next-rule behavior.","required":false},"responses":{"200":{"description":"Synchronous `{data:{escalated, reason, recipient}, took, requestId}`; no policy or completed/exhausted chain is a 200 outcome."},"400":{"description":"Invalid/missing/foreign/different policy selector; no state change or notification."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Escalate now (runs the next escalation rule)","tags":["Alerts"]}},"/v2/alerts/{identifier}/notes":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the alert's notes","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{text}` — the note content","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add a note","tags":["Alerts"]}},"/v2/alerts/{identifier}/priority":{"put":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{\"priority\":\"P1\" through \"P5\"}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Change an alert's priority without re-running policies or escalation","tags":["Alerts"]}},"/v2/alerts/{identifier}/process-escalation":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Internal: evaluate + fire the alert's due escalation rule","tags":["Alerts"]}},"/v2/alerts/{identifier}/read":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mark read (clears the unread badge)","tags":["Alerts"]}},"/v2/alerts/{identifier}/recipients":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List everyone the alert was delivered to","tags":["Alerts"]}},"/v2/alerts/{identifier}/recurrences":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Recurrence group summary plus the newest authorized alert instances, including previous/next alert links"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List deterministic occurrences linked to this alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/related":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Maximum suggestions to return (default 5, the product target is a short ranked list)","in":"query","name":"limit","required":false,"schema":{"maximum":20,"minimum":1,"type":"integer"}},{"description":"Recency window in days for candidate history (default 180)","in":"query","name":"sinceDays","required":false,"schema":{"maximum":3650,"minimum":1,"type":"integer"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{source:{kind,id}, suggestions:[…], indexState, fallback, fallbackReason, capabilities, advisory}`. Each suggestion carries kind (alert|incident), id, tinyId, title, status, priority, createdAt, an authorized `url`, an advisory `score` (a ranking signal, never a calibrated probability), concrete `reasons` (same_service, same_resource, same_error_code, similar_text, semantically_similar, same_integration, same_source, shared_tags, similar_remediation, exact_recurrence, explicit_link, confirmed_relationship) with `reasonDetails`, recurrence-group collapse (`recurrenceGroupId`, `occurrenceCount`, `groupRepresentative`), previous `responders`, a verbatim `remediationExcerpt`, and `hasPostmortem`. `indexState` is indexed|pending|indexing|failed|skipped|missing; pending and indexing both mean still indexing. `fallback` plus `fallbackReason` report a lexical-only result when embeddings are disabled, pending or unavailable. An empty `suggestions` list is a valid result. Repeated occurrences of one monitor collapse to a single representative row. Drill alerts, merged-away incidents and other tenants' resources are never suggested."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List related alerts and incidents for an alert","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{kind: alert|incident, id, note?, fromSuggestion?}` — one endpoint serves both confirming a suggestion and manually linking a pair a responder knows are connected. Stored once in canonical order, so the relationship is bidirectional by construction and re-confirming is idempotent. Both ends are re-authorized (tenant, team, visibleTo, restricted policy) before anything is written; a refused pair is indistinguishable from any other authorization failure so it cannot be used to enumerate foreign ids. Returns `{id, link:{kind,id}, result:'confirmed'}`.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Confirm or manually link a related item to an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/related/confirmed":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{links:[…]}` in the same suggestion shape. Each OTHER end is re-authorized, so a relationship to a resource the caller cannot read is omitted entirely — no title, id or hint that it exists. Recorded fact, not a similarity estimate: no score and no fuzzy reasons."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List responder-confirmed relationships for an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/related/dismiss":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{kind: alert|incident, id}` — per-user preference: one responder silencing a noisy suggestion never hides it from the rest of the team. Idempotent. Returns `{result:'dismissed'}`.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Hide a related suggestion for the calling user","tags":["Alerts"]}},"/v2/alerts/{identifier}/related/dismiss/{kind}/{relatedId}":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"in":"path","name":"kind","required":true,"schema":{"type":"string"}},{"in":"path","name":"relatedId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{result:'restored'}`. Idempotent."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Restore a dismissed related suggestion","tags":["Alerts"]}},"/v2/alerts/{identifier}/related/{kind}/{relatedId}":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"in":"path","name":"kind","required":true,"schema":{"type":"string"}},{"in":"path","name":"relatedId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{result:'unlinked'}`. Idempotent: an absent pair returns success, so a double-click or a lost response cannot fail the UI."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Remove a confirmed relationship from an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/reopen":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Optional `{user}` actor attribution","required":false},"responses":{"202":{"description":"Reopened."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Alert not found in the caller's tenant."},"409":{"description":"Only closed alerts can be reopened."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reopen a closed alert and resume escalation","tags":["Alerts"]}},"/v2/alerts/{identifier}/responders":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Either `{\"responder\":{\"type\":\"user\",\"username\":\"email\"}}` / `{\"responder\":{\"type\":\"team\",\"id\":\"OpsPing team ID\"}}` or native `{\"responders\":[...]}`, never both. User references resolve by OpsPing id or email username; team/schedule/escalation references require OpsPing IDs. Every reference must belong to the caller's tenant; names alone are not resolved.","required":true},"responses":{"200":{"description":"Synchronous `{data:{result:\"added\", count}, took, requestId}`."},"400":{"description":"Invalid/conflicting responder or invalid escalation reference."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"User/team/schedule reference missing or outside the tenant."},"409":{"description":"Escalation already started; policy cannot be rebound."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add responders to a running alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/rundeck-runs":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List audited Rundeck executions linked to an alert","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{integrationId, idempotencyKey, jobId, options?}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Execute an allowlisted Rundeck job from an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/snooze":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{durationMinutes?/until?}` — snooze duration","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Snooze for a duration","tags":["Alerts"]}},"/v2/alerts/{identifier}/tags":{"delete":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Opsgenie comma-separated tags, e.g. `tags=one,two`. One non-empty query value; no empty entries.","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"Native single tag. Cannot combine with tags query/body.","in":"query","name":"tag","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Optional `{\"tags\":[\"one\",\"two\"]}` instead of query parameters. Supply exactly one selector form.","required":false},"responses":{"200":{"description":"Synchronous response containing the remaining tags array."},"400":{"description":"Missing, malformed or conflicting tag selectors; no mutation."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Remove tags","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"`alias` resolves the current live occurrence inside the caller's tenant, or the newest closed occurrence when none is live. Native ID/numeric tiny-ID lookup is unchanged.","in":"query","name":"identifierType","required":false,"schema":{"enum":["id","tiny","alias"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{tags}` — tags to append","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add tags","tags":["Alerts"]}},"/v2/alerts/{identifier}/tickets":{"get":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Current and prior authorized occurrence links, including issue key, URL, remote status, actor, timestamps, and inherited occurrence context"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List Jira tickets linked to this alert recurrence","tags":["Alerts"]},"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{integrationId, idempotencyKey, summary?, description?}` — idempotencyKey uniquely claims one outbound creation attempt","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create and persist a Jira issue for an alert","tags":["Alerts"]}},"/v2/alerts/{identifier}/unacknowledge":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Un-acknowledge","tags":["Alerts"]}},"/v2/alerts/{identifier}/unsnooze":{"post":{"parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"End a snooze early","tags":["Alerts"]}},"/v2/announcements":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List announcements","tags":["Announcements"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Announcement fields (title, body, severity, audience, serviceIds, expiresAt)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Publish an announcement","tags":["Announcements"]}},"/v2/announcements/audience-preview":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview how many users an audience targets","tags":["Announcements"]}},"/v2/announcements/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an announcement","tags":["Announcements"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get an announcement","tags":["Announcements"]}},"/v2/approval-pending":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List pending approvals","tags":["Approvals"]}},"/v2/approval-pending/{messageType}/{id}/approve":{"post":{"parameters":[{"in":"path","name":"messageType","required":true,"schema":{"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{reason?}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Approve a pending item","tags":["Approvals"]}},"/v2/approval-pending/{messageType}/{id}/comment":{"post":{"parameters":[{"in":"path","name":"messageType","required":true,"schema":{"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{comment}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Comment on a pending item","tags":["Approvals"]}},"/v2/approval-pending/{messageType}/{id}/reject":{"post":{"parameters":[{"in":"path","name":"messageType","required":true,"schema":{"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{reason?}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reject a pending item","tags":["Approvals"]}},"/v2/approval-policies":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List approval policies","tags":["Approvals"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Policy list (level, messageType, statusPageId, gateGroups)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Replace the tenant's approval policies","tags":["Approvals"]}},"/v2/approval-policies/{policyId}":{"delete":{"parameters":[{"in":"path","name":"policyId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an approval policy","tags":["Approvals"]}},"/v2/audit-log":{"get":{"parameters":[{"description":"Exact entity type filter.","in":"query","name":"entityType","required":false,"schema":{"type":"string"}},{"description":"Exact string userId or case-insensitive substring of a string userName; non-string legacy values do not match.","in":"query","name":"user","required":false,"schema":{"type":"string"}},{"description":"Exact string action filter.","in":"query","name":"action","required":false,"schema":{"type":"string"}},{"description":"Inclusive lower timestamp; ISO or YYYY-MM-DD. ParseJSTime-compatible whitespace is preserved.","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Inclusive upper timestamp; date-only values include that UTC day.","in":"query","name":"to","required":false,"schema":{"type":"string"}},{"description":"Case-insensitive literal substring across user/action/entity/details fields.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Maximum raw rows examined and maximum matches returned by this request.","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Raw keyset continuation from nextCursor. Follow it even after an underfilled/empty refined batch; older matches remain discoverable.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Newest-first matches from one bounded raw tenant batch. `totalCount` is this batch's match count, not a global total. `nextCursor` is emitted whenever more raw rows remain, including when q/team refinement returns zero matches; follow it to continue searching without an unbounded database scan."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Audit log (admin)","tags":["Audit Log"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Append an audit-log entry","tags":["Audit Log"]}},"/v2/auth/change-password":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Change the caller's password","tags":["Auth"]}},"/v2/auth/disclaimer-accept":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Record acceptance of the usage disclaimer","tags":["Auth"]}},"/v2/auth/email-change":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{newEmail, currentPassword}","required":true},"responses":{"200":{"description":"{result: verification_sent} — identical for all syntactically valid candidates"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Request an email change (phase 1 — mailbox proof): password re-entry; SSO/API-key identities rejected. Records and emails a one-time 15-minute verification capability for every syntactically valid candidate without checking or revealing occupancy. No identity/session state changes in this phase.","tags":["Auth"]}},"/v2/auth/email-change/cancel":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{token}","required":true},"responses":{"200":{"description":"{result: email_change_canceled}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Cancel a pending email change with the emailed fragment-carried token — restores the previous address and signs out all sessions (one-time; unknown/expired/used/revoked/stale links share one generic response; a claimed previous address answers 409 and is never restored over its new owner)","tags":["Auth"]}},"/v2/auth/email-change/confirm":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{token}","required":true},"responses":{"200":{"description":"{result: email_changed}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Confirm an email change with the emailed one-time capability (phase 2): after mailbox proof, checks global uniqueness, atomically swaps the address, revokes sessions, reserves the old address for the 24-hour rollback window, and sends old/new mailbox notices. The explicit POST consumes the capability; delivery failure compensates atomically.","tags":["Auth"]}},"/v2/auth/forgot":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Request a password-reset email","tags":["Auth"]}},"/v2/auth/login":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Password login (returns JWT + refresh; MFA challenge if enrolled)","tags":["Auth"]}},"/v2/auth/login/mfa":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Complete MFA challenge","tags":["Auth"]}},"/v2/auth/login/mfa/backup":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Complete MFA challenge with a backup code","tags":["Auth"]}},"/v2/auth/logout":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Revoke the current session","tags":["Auth"]}},"/v2/auth/me":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Current user + permissions","tags":["Auth"]}},"/v2/auth/mfa/disable":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Disable MFA (password re-entry)","tags":["Auth"]}},"/v2/auth/mfa/enroll":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Begin MFA enrollment","tags":["Auth"]}},"/v2/auth/mfa/verify":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Confirm MFA enrollment","tags":["Auth"]}},"/v2/auth/pair":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Pair the mobile app (returns device tokens)","tags":["Auth"]}},"/v2/auth/pair/exchange":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Exchange a pairing code for tokens","tags":["Auth"]}},"/v2/auth/refresh":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Rotate the refresh token and mint a new access token","tags":["Auth"]}},"/v2/auth/refresh-session":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rotate the SPA session cookie","tags":["Auth"]}},"/v2/auth/register":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Create a tenant (invite-only permits verified same-email migrationJobId + migrationToken proof)","tags":["Auth"]}},"/v2/auth/reset":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Complete a password reset (single-use token)","tags":["Auth"]}},"/v2/auth/revoke-all":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Revoke every session + bump tokenVersion","tags":["Auth"]}},"/v2/auth/session-policy":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{maxIdleMinutes, hardMaxMinutes, minIdleMinutes, defaultMaxIdleMinutes}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the calling tenant's session idle-timeout ceiling and platform bounds","tags":["Auth"]},"patch":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{maxIdleMinutes: number} — validated against platform bounds; session-mint origin checks apply","required":true},"responses":{"200":{"description":"{maxIdleMinutes}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update the tenant session idle-timeout ceiling (tenant admin)","tags":["Auth"]}},"/v2/auth/sso/callback":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"SSO callback (exchanges the IdP code)","tags":["Auth"]}},"/v2/auth/sso/link":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{linkToken, password?, currentCode?} — signed SSO-link capability plus a current human session, current password with MFA when enabled, or current MFA for a passwordless SSO account","required":true},"responses":{"200":{"description":"{result: sso_linked, teamSlug} — restart SSO after linking and complete MFA when enabled"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Bind a verified SSO identity using current-account proof; does not mint a session","tags":["Auth"]}},"/v2/auth/sso/{teamSlug}":{"get":{"parameters":[{"in":"path","name":"teamSlug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Start the SSO redirect for a team slug","tags":["Auth"]}},"/v2/billing/checkout":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{tier: team|business, interval: month|year, seats: integer}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a hosted Stripe subscription Checkout Session","tags":["Billing"]}},"/v2/billing/invoices":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List Stripe invoices for the tenant","tags":["Billing"]}},"/v2/billing/portal":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"No request body","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a Stripe Customer Portal session","tags":["Billing"]}},"/v2/billing/subscription":{"patch":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{tier: team|business, seats: integer}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Change a Stripe subscription tier or responder quantity","tags":["Billing"]}},"/v2/billing/summary":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Current entitlement, invoices, and purchasable Stripe plans","tags":["Billing"]}},"/v2/billing/webhook":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Stripe subscription and invoice lifecycle webhook","tags":["Billing"]}},"/v2/changes/config":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{integrations:[{id,provider,name,enabled,webhookUrl,secretConfigured}], mappings:[{id,provider,repoSlug,environment,serviceId,…}], lookbackMinutes}`. Provider webhook secrets are never returned — `secretConfigured` reports presence only, and `webhookUrl` embeds the URL token so it is admin-gated by the `integrations` permission resource."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the tenant's provider integrations, repo mappings and lookback window","tags":["Deployments"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{lookbackMinutes?, githubSecret?, gitlabSecret?}` — each field is optional and only supplied fields are written. `lookbackMinutes` must be a number between 5 and 1440 (`400 lookbackMinutes must be between 5 and 1440` otherwise). Secrets are stored hashed; supplying an empty or non-string secret for a provider is ignored rather than clearing it. Returns `{lookbackMinutes, result:'saved'}`.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Set the correlation lookback window and provider webhook secrets","tags":["Deployments"]}},"/v2/changes/mappings":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{repoSlug, serviceId, provider?, environment?}` — `repoSlug` and `serviceId` are required (`400 repoSlug is required` / `400 serviceId is required`); `serviceId` must exist in the caller's tenant (`400 Unknown serviceId`); `provider` must be `github`, `gitlab` or empty for any (`400 provider must be 'github', 'gitlab' or empty (any)`).","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Map a repository slug to a service so its deployments correlate","tags":["Deployments"]}},"/v2/changes/mappings/{id}":{"delete":{"parameters":[{"description":"Mapping ID.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{result:'deleted'}`. Tenant-scoped: the delete is filtered by the caller's tenant, so a mapping belonging to another tenant deletes zero rows and reads as `404 NOT_FOUND Mapping not found` rather than forbidden — foreign ids cannot be enumerated."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Remove a repository-to-service mapping","tags":["Deployments"]}},"/v2/channels":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"authoringEnabled":{"description":"Whether the durable erasure-aware compatibility floor permits feature authoring. Independent of execution, classification, attester and provider readiness; absent or unknown means closed.","type":"boolean"},"channels":{"items":{"type":"object"},"type":"array"},"ok":{"type":"boolean"},"providerDisabled":{"type":"boolean"},"providers":{"additionalProperties":{"type":"boolean"},"type":"object"}},"required":["authoringEnabled"],"type":"object"}}},"description":"Authorized metadata; no operator cross-tenant inventory is exposed."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the caller's notification channels","tags":["Channels"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{type, value, label}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a notification channel (email/phone)","tags":["Channels"]}},"/v2/channels/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a notification channel","tags":["Channels"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{label}` and/or `{type, value}` — destination change requires re-verification","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a channel — rename (label only, verification kept) or change the destination (`type`+`value`: verified/test state reset, fresh code issued)","tags":["Channels"]}},"/v2/channels/{id}/consent":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{consent:boolean}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Opt in to or immediately withdraw the owner's WhatsApp consent","tags":["Channels"]}},"/v2/channels/{id}/resend":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Resend the verification code","tags":["Channels"]}},"/v2/channels/{id}/test":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Send a test notification to the channel","tags":["Channels"]}},"/v2/channels/{id}/verify":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{code}` — the verification code","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Verify a channel with its code","tags":["Channels"]}},"/v2/contact":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Public contact form (rate-limited, no auth)","tags":["General"]}},"/v2/contact/callflow-inquiry":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Submit a public call-flow product inquiry (rate-limited)","tags":["General"]}},"/v2/devices":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Registered device inventory and liveness (admin)","tags":["Devices"]}},"/v2/devices/health":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Report a pre-shift device health check","tags":["Devices"]}},"/v2/devices/health-report":{"get":{"parameters":[{"description":"Lower bound on `shiftStart` (ISO timestamp or YYYY-MM-DD day). LTF-996: tenant scope, window and the 200-row cap are SQL predicates — only the caller's tenant's checks are read.","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Recent device health checks (admin; `?since=` bounds the window, ISO or YYYY-MM-DD, invalid → 400)","tags":["Devices"]}},"/v2/drills/availability":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"properties":{"authoringEnabled":{"description":"Whether the durable erasure-aware compatibility floor permits feature authoring. Independent of execution, classification, attester and provider readiness; absent or unknown means closed.","type":"boolean"},"enabled":{"type":"boolean"},"reason":{"type":"string"}},"required":["authoringEnabled"],"type":"object"}},"required":["data"],"type":"object"}}},"description":"Authorized metadata; no operator cross-tenant inventory is exposed."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read explicit drill paging activation state (off until rollback baseline is drill-aware)","tags":["Wargames"]}},"/v2/drills/opt-out":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the current user's drill opt-out preference","tags":["Wargames"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Set the current user's drill opt-out preference","tags":["Wargames"]}},"/v2/drills/preflight":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. Drill paging is not activated (DRILLS_ENABLED is not 1), or safety integration is unavailable."}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview the real recipients, eligibility and voice budget before paging","tags":["Wargames"]}},"/v2/drills/presets":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get first-week migration, quarterly and evidence grading presets","tags":["Wargames"]}},"/v2/drills/runs":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List visible drill runs and cards","tags":["Wargames"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. Drill paging is not activated (DRILLS_ENABLED is not 1), or safety integration is unavailable."}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Queue an ad hoc or scheduled single-service/policy drill","tags":["Wargames"]}},"/v2/drills/runs/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read a drill run with fresh tenant/team/eligibility authorization","tags":["Wargames"]}},"/v2/drills/runs/{id}/abort":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Abort as owner, administrator or paged responder","tags":["Wargames"]}},"/v2/drills/runs/{id}/complete":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"End a run and generate its graded report card","tags":["Wargames"]}},"/v2/drills/runs/{id}/events":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the private drill evidence timeline","tags":["Wargames"]}},"/v2/drills/runs/{id}/export":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Export format; response includes X-OpsPing-Integrity-SHA256.","in":"query","name":"format","required":false,"schema":{"enum":["pdf","csv","json"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Export private report evidence and a stable integrity hash","tags":["Wargames"]}},"/v2/drills/runs/{id}/mitigate":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Record mitigation with a server-side timestamp","tags":["Wargames"]}},"/v2/drills/runs/{id}/voice-calls":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read provider-reported drill voice connectivity charges","tags":["Wargames"]}},"/v2/drills/schedules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List recurring drill schedules","tags":["Wargames"]}},"/v2/drills/schedules/{id}/disable":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Disable future occurrences of a drill schedule","tags":["Wargames"]}},"/v2/drills/templates":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List visible versioned drill templates","tags":["Wargames"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a drill template or append its next immutable version","tags":["Wargames"]}},"/v2/escalations":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List escalation policies (with rules)","tags":["Escalations"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Policy fields (name, rules, priorities, repeat, teamId, isDefault, …)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an escalation policy","tags":["Escalations"]}},"/v2/escalations/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a policy","tags":["Escalations"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one escalation policy","tags":["Escalations"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Policy fields (rules replace the existing set)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Replace the policy's rules","tags":["Escalations"]}},"/v2/escalations/{id}/simulate":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{policyId, policyName, simulatedAt, steps: [{order, condition, notifyType, delayMinutes, recipientType/Id/Name, channel, wouldNotify, users: [{userId, userName, pushTokens}]}]}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Simulate who gets paged at each step right now (read-only; no notifications sent)","tags":["Escalations"]}},"/v2/events":{"get":{"parameters":[{"description":"Compatible-client marker for browser EventSource, which cannot send custom headers. Only accepted on this SSE route.","in":"query","name":"incidentAccess","required":false,"schema":{"enum":["1"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`text/event-stream`; `event:`/`data:` frames with heartbeat comments every 25s"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Server-sent events: live tenant-scoped change notifications (refetch signal only)","tags":["Events"]}},"/v2/export":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Full JSON export of this tenant's data","tags":["General"]}},"/v2/feedback":{"get":{"parameters":[{"description":"Page size (LTF-985: bounded keyset read — was the unpaginated whole-tenant scan).","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"base64url JSON `{\"sk\": ...}` keyset cursor from the previous page's `nextCursor`; absent starts at the newest.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Summary rows (id, tenantId, userId, userEmail, app, truncated description, status, createdAt, breadcrumbCount) newest-first plus `nextCursor` while more pages remain; diagnostics/breadcrumbs stay in `GET /{id}`."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List submitted feedback (tenant admin)","tags":["Feedback"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Feedback fields (app, message, breadcrumbs)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Submit in-app feedback (mobile/admin)","tags":["Feedback"]}},"/v2/feedback/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one feedback report (tenant admin)","tags":["Feedback"]}},"/v2/forwarding-rules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List alert-forwarding rules","tags":["Forwarding Rules"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields (source, target, enabled)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a forwarding rule","tags":["Forwarding Rules"]}},"/v2/forwarding-rules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a forwarding rule","tags":["Forwarding Rules"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one forwarding rule","tags":["Forwarding Rules"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Full rule document","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Replace a forwarding rule","tags":["Forwarding Rules"]}},"/v2/heartbeats":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List heartbeats","tags":["Heartbeats"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Heartbeat config (name, interval, grace period)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a heartbeat (periodic ping check)","tags":["Heartbeats"]}},"/v2/heartbeats/{name}":{"delete":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a heartbeat","tags":["Heartbeats"]},"get":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a heartbeat","tags":["Heartbeats"]},"patch":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Heartbeat fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a heartbeat","tags":["Heartbeats"]}},"/v2/heartbeats/{name}/ping":{"get":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Ping a heartbeat using GET (keeps it green)","tags":["Heartbeats"]},"patch":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Ping a heartbeat using PATCH (keeps it green)","tags":["Heartbeats"]},"post":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Ping a heartbeat using POST (keeps it green)","tags":["Heartbeats"]},"put":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Ping a heartbeat using PUT (keeps it green)","tags":["Heartbeats"]}},"/v2/incident-automations":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:{automations:[Definition]}}. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,priorities,statuses,customFields:[{fieldId,value:string|number}]},action:{type:webhook|enrich,integrationId,action?,parameters?,mappings?:[{source,fieldId}]},createdAt,updatedAt}. Triggers: incident.created, incident.updated, incident.services_changed, incident.status_changed, incident.custom_fields_changed. Exact typed custom-field equality or multi-select membership; dimensions AND, arrays OR."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List authorized tenant incident automations","tags":["Incidents"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Definition without server-owned id/timestamps. Optional enabled/archived default false, teamId defaults null, condition dimensions default empty. Enrichment requires an enabled same-tenant/team action-bridge integration, an allowlisted action and stable field mappings. Webhook requires an enabled webhook integration with signingSecret. Both require guarded HTTPS. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,priorities,statuses,customFields:[{fieldId,value:string|number}]},action:{type:webhook|enrich,integrationId,action?,parameters?,mappings?:[{source,fieldId}]},createdAt,updatedAt}. Triggers: incident.created, incident.updated, incident.services_changed, incident.status_changed, incident.custom_fields_changed. Exact typed custom-field equality or multi-select membership; dimensions AND, arrays OR.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an incident automation (admin session only)","tags":["Incidents"]}},"/v2/incident-automations/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,priorities,statuses,customFields:[{fieldId,value:string|number}]},action:{type:webhook|enrich,integrationId,action?,parameters?,mappings?:[{source,fieldId}]},createdAt,updatedAt}. Triggers: incident.created, incident.updated, incident.services_changed, incident.status_changed, incident.custom_fields_changed. Exact typed custom-field equality or multi-select membership; dimensions AND, arrays OR."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read an authorized incident automation","tags":["Incidents"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Partial definition. Supplied conditions/action replace the complete nested object; omitted properties persist. Archive instead of deleting history. Archived automations cannot be enabled. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,priorities,statuses,customFields:[{fieldId,value:string|number}]},action:{type:webhook|enrich,integrationId,action?,parameters?,mappings?:[{source,fieldId}]},createdAt,updatedAt}. Triggers: incident.created, incident.updated, incident.services_changed, incident.status_changed, incident.custom_fields_changed. Exact typed custom-field equality or multi-select membership; dimensions AND, arrays OR.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Concurrent edit; refresh before saving."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Edit, enable or archive an automation (admin session only)","tags":["Incidents"]}},"/v2/incident-automations/{id}/runs":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Page size, default 50.","in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"description":"Opaque exclusive createdAt/id nextCursor; malformed cursors return 400.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Paged list envelope of {id,automationId,incidentId,trigger,status,attempts,createdAt,updatedAt,lastError?}. Status pending|running|succeeded|failed|stale|blocked. Current tenant/team/mandatory incident restrictions filter before totals and slicing. No raw request/response payloads or secrets. Terminal history retained 30 days."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read authorized paginated automation run history","tags":["Incidents"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{incidentId}. Admin session and current incident authorization required; disabled/archived/restricted-outbound actions cannot run. This executes a real action, not a dry run, and does not replay an earlier payload.","required":true},"responses":{"202":{"description":"Run enqueued durably; data is the pending Run record."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Configuration or incident changed; refresh and retry."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Run now: enqueue the configured action against fresh incident state","tags":["Incidents"]}},"/v2/incident-playbooks":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:{playbooks:[Definition]}}. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,severities},actions:[{type,message?,text?,body?}],createdAt,updatedAt}. Triggers: incident.created, incident.severity_raised. Actions allowlist: notify_responders, incident_channel, slack_message, zoom_bridge, status_update_draft. Template placeholders: incident.name/severity/status/priority/message/id."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List authorized tenant incident playbooks","tags":["Incidents"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Definition without server-owned id/timestamps. enabled/archived default false, teamId defaults null, condition dimensions default empty. 1-10 allowlisted actions; validation is local and never performs outbound network work. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,severities},actions:[{type,message?,text?,body?}],createdAt,updatedAt}. Triggers: incident.created, incident.severity_raised. Actions allowlist: notify_responders, incident_channel, slack_message, zoom_bridge, status_update_draft. Template placeholders: incident.name/severity/status/priority/message/id.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an incident playbook (admin session only)","tags":["Incidents"]}},"/v2/incident-playbooks/preview":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{playbook: Definition-without-server-id, incidentId?: string}. With incidentId the current incident is matched against conditions; without it the response describes behavior only.","required":true},"responses":{"200":{"description":"{trigger,matches:boolean|null,reason,actions:[{index,type,description,text}]}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview a playbook draft's trigger match and ordered actions (dry run, no side effects)","tags":["Incidents"]}},"/v2/incident-playbooks/settings":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{enabled:boolean}. Execution stays off until an administrator enables it here; authoring is always available."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the workspace playbook rollout flag (default false)","tags":["Incidents"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{enabled:boolean}","required":true},"responses":{"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Enable or disable playbook execution for the workspace (admin session only)","tags":["Incidents"]}},"/v2/incident-playbooks/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,severities},actions:[{type,message?,text?,body?}],createdAt,updatedAt}. Triggers: incident.created, incident.severity_raised. Actions allowlist: notify_responders, incident_channel, slack_message, zoom_bridge, status_update_draft. Template placeholders: incident.name/severity/status/priority/message/id."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read an authorized incident playbook","tags":["Incidents"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Partial definition. Supplied conditions/actions replace the complete arrays; omitted properties persist. Archived playbooks cannot be enabled. {id,name,enabled,archived,trigger,teamId,conditions:{serviceIds,severities},actions:[{type,message?,text?,body?}],createdAt,updatedAt}. Triggers: incident.created, incident.severity_raised. Actions allowlist: notify_responders, incident_channel, slack_message, zoom_bridge, status_update_draft. Template placeholders: incident.name/severity/status/priority/message/id.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Concurrent edit; refresh before saving."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Edit, enable or archive a playbook (admin session only)","tags":["Incidents"]}},"/v2/incident-playbooks/{id}/runs":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Restrict history to one authorized incident.","in":"query","name":"incidentId","required":false,"schema":{"type":"string"}},{"description":"Page size, default 50.","in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:[{id,playbookId,incidentId,trigger,status,attempts,manualRetries,createdAt,updatedAt,lastError?,steps:[{id,runId,playbookId,stepIndex,actionType,status,attempts,idempotencyKey,lastError?,result?,createdAt,updatedAt}]}]}. Status pending|running|succeeded|failed|stale|blocked; step status adds skipped. Error text is a fixed classification, never a provider response body."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read authorized playbook run history with per-step execution log","tags":["Incidents"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{incidentId}. Admin session, workspace rollout flag and current incident authorization required; disabled/archived/restricted-outbound playbooks cannot run. Executes real actions, not a dry run.","required":true},"responses":{"202":{"description":"Run enqueued durably with its materialized step log."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Workspace execution is disabled."},"409":{"description":"Configuration or incident changed; refresh and retry."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Run now: execute the playbook against fresh incident state","tags":["Incidents"]}},"/v2/incident-playbooks/{id}/runs/{runId}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Run with steps."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read one run with its step log","tags":["Incidents"]}},"/v2/incident-playbooks/{id}/runs/{runId}/retry":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{}. Failed/blocked/skipped steps re-arm under their original idempotency keys; succeeded steps never re-execute. Bounded per run (10 manual retries).","required":true},"responses":{"202":{"description":"Run re-queued."},"400":{"description":"Run is not retryable in its current state."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"429":{"description":"Manual retry limit reached."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Retry a failed, blocked or stale run (admin session only)","tags":["Incidents"]}},"/v2/incidents":{"get":{"parameters":[{"description":"Exact key from this tenant's GET /v2/incidents/statuses lifecycle (including custom keys, not aliases). Missing or empty stored statuses normalize to open. Unknown filter values return 400 VALIDATION. Omit for all statuses.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"true excludes this tenant's terminal lifecycle keys, including merged and custom terminal statuses, before count/paging. Unknown legacy statuses remain nonterminal, matching lifecycle semantics. false or omitted adds no restriction; other values return 400 VALIDATION. Intersects with status when both are supplied.","in":"query","name":"active","required":false,"schema":{"type":"boolean"}},{"description":"Tenant field ID; requires customFieldValue. Filters authorized incidents before totals/cursor.","in":"query","name":"customFieldId","required":false,"schema":{"type":"string"}},{"description":"JSON string or number: exact scalar equality, or option membership for multi-select. Includes historical archived values.","in":"query","name":"customFieldValue","required":false,"schema":{"type":"string"}},{"description":"Page size, default 50 and maximum 200.","in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"description":"Opaque nextCursor from the preceding page; unchanged exclusive newest-first createdAt/id keyset. Malformed or empty cursors return 400 PAGINATION_CURSOR_INVALID. totalCount remains the full matching scope.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Newest-first list envelope with full filtered totalCount and optional nextCursor. Tenant/team, optional exact status and active lifecycle predicates precede decoding; eligibility checks precede counting and paging."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List incidents","tags":["Incidents"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Incident fields plus optional customFields: {fieldId: string | finite number | option ID | option ID[] | null}. Five types: text (4000 chars), number (finite, representable, JSON spelling \u003c=100 chars), link (2048 chars, HTTP(S) without credentials), single-select, multi-select. Unknown or archived new selections return 400 VALIDATION.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an incident","tags":["Incidents"]}},"/v2/incidents/actions":{"get":{"parameters":[{"description":"mine requires a human JWT session; API keys must select all or unassigned.","in":"query","name":"scope","required":false,"schema":{"default":"mine","enum":["mine","all","unassigned"],"type":"string"}},{"description":"open includes every non-done action, including work on resolved or merged source incidents.","in":"query","name":"status","required":false,"schema":{"default":"open","enum":["open","done","all"],"type":"string"}},{"description":"Visible page size; totals and pagination follow all access checks.","in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Opaque cohort-bound dueAt/createdAt/id keyset cursor. Invalid or other-cohort cursors return 400.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:[Action plus incidentName,incidentStatus,incidentPriority:null|string,ownerName?:string],totalCount,nextCursor?,took,requestId}. Owner labels derive live from one scoped user batch, never stored action docs. Sort dueAt ascending (null last), then createdAt and id ascending. {id,incidentId,title,description,ownerId:null|string,status:open|in_progress|blocked|done,dueAt:null|ISO-instant,result,blockedReason,createdAt,updatedAt,completedAt:null|ISO-instant,version:integer}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List internal incident actions in the current visibility scope","tags":["Incidents"]}},"/v2/incidents/custom-fields":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{customFields: [{id, name, description, type, archived, options: [{id, name, archived}]}]}. No incident values are included."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List tenant custom field definitions including archived history","tags":["Incidents"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{name, description?, type, options?: [{name}]}. Types text/number/link/single-select/multi-select; server-generated immutable UUIDs. Maximum 50 fields, 100 options/select, 100-character names, 1000-character description.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an incident custom field (admin session only)","tags":["Incidents"]}},"/v2/incidents/custom-fields/{fieldId}":{"patch":{"parameters":[{"in":"path","name":"fieldId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{name?, description?, archived?, options?: [{id?, name, archived?}]}. Type immutable. Existing option IDs must be retained; archive instead of deleting. Omitted options preserve all options; omit ID only for a new option.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Edit or archive an incident custom field (admin session only)","tags":["Incidents"]}},"/v2/incidents/participant-suggestions":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Suggested incident participants for autocomplete","tags":["Incidents"]}},"/v2/incidents/statuses":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get the tenant's incident status lifecycle (defaults materialize when unset)","tags":["Incidents"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{incidentStatuses: [{key, label, abbrev, emoji, aliases, terminal, builtin}]}` — 409 when a removed status is still used by incidents","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Replace the tenant's incident status lifecycle (admin session)","tags":["Incidents"]}},"/v2/incidents/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an incident","tags":["Incidents"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get an incident","tags":["Incidents"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Incident fields to change. customFields is a partial object keyed by stable field ID: omitted map/keys preserve stored values, per-key null clears, [] clears multi-select. Archived fields/options remain readable and retainable but not newly selectable. Tenant/team/mandatory incident access checks apply before mutation.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update an incident","tags":["Incidents"]}},"/v2/incidents/{id}/action-assignees":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:[{id,fullName?,username?}],took,requestId}. Names are read live, never copied into action documents."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Incident is missing or outside the current visibility scope."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List active eligible incident action owners","tags":["Incidents"]}},"/v2/incidents/{id}/actions":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:[Action plus incidentName,incidentStatus,incidentPriority:null|string,ownerName?:string],totalCount,took,requestId}; no truncation, including merged sources. Owner labels derive live from scoped users. {id,incidentId,title,description,ownerId:null|string,status:open|in_progress|blocked|done,dueAt:null|ISO-instant,result,blockedReason,createdAt,updatedAt,completedAt:null|ISO-instant,version:integer}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Incident is missing or outside the current visibility scope."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List every internal action on the authorized actual incident","tags":["Incidents"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Editable fields: title (trimmed, 1..200 characters), description/result/blockedReason (strings, \u003c=4000 characters), ownerId (eligible active same-tenant incident reader or null), status (open default; in_progress|blocked|done), dueAt (ISO instant or null). Blocked requires nonblank blockedReason. Unknown fields are ignored. Omitted fields persist on PATCH. Findings survive reopen; completion does not resolve the parent.","required":true},"responses":{"201":{"description":"Created; data contains the persisted Action."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Incident is missing or outside the current visibility scope."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create internal incident work","tags":["Incidents"]}},"/v2/incidents/{id}/actions/{actionId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"actionId","required":true,"schema":{"type":"string"}},{"description":"Required current action version.","in":"query","name":"version","required":true,"schema":{"minimum":1,"type":"integer"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data:{result:Deleted},took,requestId}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Incident/action is missing, mismatched or outside the current visibility scope."},"409":{"description":"Version or parent incarnation changed; reload/review."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete internal incident work with optimistic concurrency","tags":["Incidents"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"actionId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Required positive integer version plus partial editable fields. Editable fields: title (trimmed, 1..200 characters), description/result/blockedReason (strings, \u003c=4000 characters), ownerId (eligible active same-tenant incident reader or null), status (open default; in_progress|blocked|done), dueAt (ISO instant or null). Blocked requires nonblank blockedReason. Unknown fields are ignored. Omitted fields persist on PATCH. Findings survive reopen; completion does not resolve the parent.","required":true},"responses":{"200":{"description":"{id,incidentId,title,description,ownerId:null|string,status:open|in_progress|blocked|done,dueAt:null|ISO-instant,result,blockedReason,createdAt,updatedAt,completedAt:null|ISO-instant,version:integer}"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Incident/action is missing, mismatched or outside the current visibility scope."},"409":{"description":"Version or parent incarnation changed; preserve draft and reload/review."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Edit internal work with optimistic concurrency","tags":["Incidents"]}},"/v2/incidents/{id}/changes":{"get":{"parameters":[{"description":"Incident ID.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Same `{state, lookbackMinutes, changes:[…]}` shape as the alert endpoint. Correlates across the union of the incident's `impactedServices` with the incident's `createdAt` as the window start."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List deployment changes correlated to an incident's services","tags":["Deployments"]}},"/v2/incidents/{id}/merge":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{\"targetId\", \"reason?\"}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Merge this incident into another incident","tags":["Incidents"]}},"/v2/incidents/{id}/public-summary-approval":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{publicTitle,publicSummary,status}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Separately approve a public snapshot without exposing restricted live content","tags":["Incident Access"]}},"/v2/incidents/{id}/related":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Maximum suggestions to return (default 5)","in":"query","name":"limit","required":false,"schema":{"maximum":20,"minimum":1,"type":"integer"}},{"description":"Recency window in days for candidate history (default 180)","in":"query","name":"sinceDays","required":false,"schema":{"maximum":3650,"minimum":1,"type":"integer"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Identical shape to the alert endpoint, including the same authorization model and the same advisory-not-probability `score`. Cross-type by design: an incident surfaces related alerts and other incidents."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List related alerts and incidents for an incident","tags":["Incidents"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{kind: alert|incident, id, note?, fromSuggestion?}` — same canonical, idempotent, both-ends-authorized semantics as the alert endpoint.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Confirm or manually link a related item to an incident","tags":["Incidents"]}},"/v2/incidents/{id}/related/confirmed":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{links:[…]}` — same shape and re-authorization rule as the alert endpoint."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List responder-confirmed relationships for an incident","tags":["Incidents"]}},"/v2/incidents/{id}/related/dismiss":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{kind: alert|incident, id}` — per-user. Idempotent. Returns `{result:'dismissed'}`.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Hide a related suggestion for the calling user","tags":["Incidents"]}},"/v2/incidents/{id}/related/dismiss/{kind}/{relatedId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"kind","required":true,"schema":{"type":"string"}},{"in":"path","name":"relatedId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{result:'restored'}`. Idempotent."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Restore a dismissed related suggestion","tags":["Incidents"]}},"/v2/incidents/{id}/related/{kind}/{relatedId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"kind","required":true,"schema":{"type":"string"}},{"in":"path","name":"relatedId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{result:'unlinked'}`. Idempotent."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Remove a confirmed relationship from an incident","tags":["Incidents"]}},"/v2/incidents/{id}/restriction-policy":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"properties":{"authoringEnabled":{"description":"Whether the durable erasure-aware compatibility floor permits feature authoring. Independent of execution, classification, attester and provider readiness; absent or unknown means closed.","type":"boolean"},"restricted":{"type":"boolean"}},"required":["authoringEnabled"],"type":"object"}},"required":["data"],"type":"object"}}},"description":"Authorized metadata; no operator cross-tenant inventory is exposed."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read effective requirements with the incident's normal access checks","tags":["Incident Access"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{requirements}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add incident eligibility requirements; never loosen inherited policy","tags":["Incident Access"]}},"/v2/incidents/{id}/status-updates":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List an incident's status updates","tags":["Incidents"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{message, …}` — the update text","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Post a status update","tags":["Incidents"]}},"/v2/incidents/{id}/status-updates/{updateId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"updateId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a status update","tags":["Incidents"]}},"/v2/integrations":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List integrations","tags":["Integrations"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Integration fields (name, type, teamId, config, enabled, generateKey)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an integration","tags":["Integrations"]}},"/v2/integrations/authenticate":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Provider type + credentials to verify","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Verify provider credentials before saving","tags":["Integrations"]}},"/v2/integrations/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an integration","tags":["Integrations"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one integration","tags":["Integrations"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Integration fields to change (including nullable teamId)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update an integration","tags":["Integrations"]}},"/v2/integrations/{id}/disable":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Disable the integration","tags":["Integrations"]}},"/v2/integrations/{id}/enable":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Enable the integration","tags":["Integrations"]}},"/v2/integrations/{id}/regenerate-key":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rotate the integration's API key","tags":["Integrations"]}},"/v2/integrations/{id}/rotate-webhook-token":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rotate the integration's inbound webhook token","tags":["Integrations"]}},"/v2/integrations/{id}/test":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Send a test payload through the integration","tags":["Integrations"]}},"/v2/internal/meeting-assistant/release-readiness":{"get":{"parameters":[{"description":"Unix seconds when the request was signed; requests more than 60 seconds from server time are refused as stale.","in":"header","name":"X-OpsPing-Release-Timestamp","required":true,"schema":{"type":"string"}},{"description":"32 random bytes encoded as unpadded base64url; echoed in the signed response body.","in":"header","name":"X-OpsPing-Release-Nonce","required":true,"schema":{"type":"string"}},{"description":"`v1=` + hex HMAC-SHA256(secret, \"v1\\nGET\\n/v2/internal/meeting-assistant/release-readiness\\n\u003chost\u003e\\n\u003ctimestamp\u003e\\n\u003cnonce\u003e\").","in":"header","name":"X-OpsPing-Release-Signature","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signed JSON `{nonce, generated_at (RFC3339 UTC), build, meetingbot_launch_enabled, meetingbot_launch_ready, meetingbot_worker_capability, meetingbot_worker_capability_fresh}`; `X-OpsPing-Release-Signature: v1=` hex HMAC-SHA256(secret, \"v1\\n\u003ctimestamp\u003e\\n\u003cnonce\u003e\\n\u003chex sha256(body)\u003e\"). The worker capability is blanked unless fresh."},"401":{"description":"Raw `{message}`. `unauthorized` when the timestamp, nonce, or request signature is missing/invalid; `stale request` when the signed timestamp is outside ±60 seconds."},"403":{"description":"Raw `{message: \"forbidden\"}` — the request `Host` does not match `MEETING_ASSISTANT_RELEASE_READINESS_HOST`."},"500":{"description":"Raw `{message: \"encode failed\"}`."},"503":{"description":"Raw `{message}`. `release readiness is not configured` (secret shorter than 32 bytes or host unset), `build identity is not release-safe` (empty/`unknown` build), or `readiness state unavailable` (database capability state could not be read)."}},"security":[{"ReleaseHMAC":[]}],"summary":"HMAC-signed Meeting Assistant release-readiness probe (host-bound, ±60s clock-skew window)","tags":["General"]}},"/v2/internal/meeting-bot/sessions/{id}/audio/upload-url":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope. `MEETINGBOT_AUDIO_NOT_RETAINED` when the org's keep_audio setting is off."},"409":{"description":"Error envelope. `MEETINGBOT_INVALID_STATE` (transient concurrent phase race) or `MEETINGBOT_TERMINAL_STATE` (fatal)."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"MeetingBotSessionAuth":[]}],"summary":"Mint a presigned SSE-KMS S3 audio upload URL for one session (keep_audio sessions only)","tags":["Meeting Assistant"]}},"/v2/internal/meeting-bot/sessions/{id}/join-config":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"MeetingBotSessionAuth":[]}],"summary":"Fetch one session's one-shot RTMS stream coordinates and settings (meeting_number, meeting_uuid, rtms_stream_id, signaling_url, client_id, signature, bot_display_name, incident_ref, glossary_terms, keep_audio)","tags":["Meeting Assistant"]}},"/v2/internal/meeting-bot/sessions/{id}/status":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{status, error?}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"MeetingBotSessionAuth":[]}],"summary":"Advance one Meeting Assistant session's status","tags":["Meeting Assistant"]}},"/v2/internal/meeting-bot/sessions/{id}/transcript-complete":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{language, duration_seconds, speaker_count, checksum_sha256}; checksum_sha256 is required standard padded base64 SHA-256 of the exact PUT bytes and is echoed on every 200.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope; missing/invalid `checksum_sha256` is MEETINGBOT_TRANSCRIPT_CHECKSUM_REQUIRED."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Error envelope. `MEETINGBOT_INVALID_STATE` is the only retryable code (concurrent phase race); `MEETINGBOT_TERMINAL_STATE`, `MEETINGBOT_TRANSCRIPT_MISSING` and `transcript_checksum_mismatch` are fatal."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"MeetingBotSessionAuth":[]}],"summary":"Verify a transcript upload and queue summarization","tags":["Meeting Assistant"]}},"/v2/internal/meeting-bot/sessions/{id}/transcript-upload-url":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Standard padded base64 SHA-256 of the exact PUT bytes. The signed response headers include x-amz-checksum-sha256 with the same value; send them verbatim on the PUT.","in":"header","name":"X-OpsPing-Transcript-SHA256","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`; missing/malformed/duplicate `X-OpsPing-Transcript-SHA256` is MEETINGBOT_TRANSCRIPT_CHECKSUM_REQUIRED."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Error envelope. `MEETINGBOT_INVALID_STATE` (transient concurrent phase race) or `MEETINGBOT_TERMINAL_STATE` (fatal)."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"MeetingBotSessionAuth":[]}],"summary":"Mint a presigned S3 transcript upload URL for one session","tags":["Meeting Assistant"]}},"/v2/invites":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List pending invites (admin)","tags":["Invites"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{email, role, teamIds…}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Invite a user (sends the invite email)","tags":["Invites"]}},"/v2/invites/{token}":{"delete":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Revoke a pending invite","tags":["Invites"]},"get":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Validate an invite token (public — signup page)","tags":["Invites"]}},"/v2/invites/{token}/accept":{"post":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{password, name…}` — the new account","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Accept an invite (creates the user)","tags":["Invites"]}},"/v2/maintenance-windows":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List maintenance windows","tags":["Maintenance Windows"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Window fields (scope, startTime, endTime)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a maintenance window","tags":["Maintenance Windows"]}},"/v2/maintenance-windows/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a maintenance window","tags":["Maintenance Windows"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a maintenance window","tags":["Maintenance Windows"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Window fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a maintenance window","tags":["Maintenance Windows"]}},"/v2/meetings":{"get":{"parameters":[{"description":"List sessions attached to this incident. Requires incident read access.","in":"query","name":"incident_id","required":false,"schema":{"type":"string"}},{"description":"List the signed-in user's 50 most recent launches when set to `1`.","in":"query","name":"requested_by_me","required":false,"schema":{"enum":["1"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List incident Meeting Assistant sessions","tags":["Meeting Assistant"]}},"/v2/meetings/improvements":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the caller's Meeting Assistant improvement submissions","tags":["Meeting Assistant"]}},"/v2/meetings/improvements/count":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Count the caller's open Meeting Assistant improvement submissions","tags":["Meeting Assistant"]}},"/v2/meetings/improvements/{id}/triage":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{status, outcome?}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Accept, reject, or close an improvement submission (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/sessions":{"get":{"parameters":[{"description":"List sessions attached to this incident. Requires incident read access.","in":"query","name":"incident_id","required":false,"schema":{"type":"string"}},{"description":"List the signed-in user's 50 most recent launches when set to `1`.","in":"query","name":"requested_by_me","required":false,"schema":{"enum":["1"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List incident sessions or the signed-in user's recent launches","tags":["Meeting Assistant"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{zoom_url, incident_id?}. Unknown fields, bodies over 16 KiB, non-Zoom hosts, and invalid meeting IDs are rejected. The URL and passcode are never returned.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Launch one hosted Meeting Assistant task for a Zoom meeting","tags":["Meeting Assistant"]}},"/v2/meetings/sessions/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one authorized Meeting Assistant session and its summaries","tags":["Meeting Assistant"]}},"/v2/meetings/sessions/{id}/improvements":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{source, note?, outcome?, wrong_text?, corrected_text?, summary_id?}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Submit vocabulary or summary feedback for a session","tags":["Meeting Assistant"]}},"/v2/meetings/sessions/{id}/summaries/{summaryId}/revisions":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"summaryId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List saved summary correction revisions","tags":["Meeting Assistant"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"summaryId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{summary_text}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Save a corrected summary revision (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/sessions/{id}/transcript":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Return a 302 to a five-minute presigned S3 URL instead of proxying transcript JSON.","in":"query","name":"redirect","required":false,"schema":{"enum":["1"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read one authorized session's transcript","tags":["Meeting Assistant"]}},"/v2/meetings/settings":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the tenant's Meeting Assistant settings","tags":["Meeting Assistant"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{enabled, auto_detect_links, summary_mode, customer_ai_endpoint_url, customer_auth_header?, customer_prompt, summary_instructions, post_to_slack, attach_to_incident, transcript_retention_days}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update the tenant's Meeting Assistant settings (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/settings/hmac-key/rotate":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"{data: {hmacKey}}. The previous key becomes invalid immediately."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rotate the customer-endpoint signature key (admin; shown once)","tags":["Meeting Assistant"]}},"/v2/meetings/vocabulary":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List tenant Meeting Assistant glossary terms","tags":["Meeting Assistant"]}},"/v2/meetings/vocabulary/export":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Export glossary terms as CSV (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/vocabulary/import":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"CSV glossary upload","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Import glossary terms from CSV (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/vocabulary/terms":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{term, type, definition, aliases, pinned}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a glossary term (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/vocabulary/terms/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a glossary term (admin)","tags":["Meeting Assistant"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{term, type, definition, aliases, pinned}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a glossary term (admin)","tags":["Meeting Assistant"]}},"/v2/meetings/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one Meeting Assistant session and its summaries","tags":["Meeting Assistant"]}},"/v2/meetings/{id}/transcript":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Return a 302 to a five-minute presigned S3 URL instead of proxying transcript JSON.","in":"query","name":"redirect","required":false,"schema":{"enum":["1"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read one session's transcript","tags":["Meeting Assistant"]}},"/v2/notification-rules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the caller's notification rules","tags":["Notification Rules"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields (name, criteria, action, repeat, priority, enabled)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a notification rule (per-user)","tags":["Notification Rules"]}},"/v2/notification-rules/reorder":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{ids}` — rules in the new order","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reorder the caller's rules","tags":["Notification Rules"]}},"/v2/notification-rules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a notification rule","tags":["Notification Rules"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one notification rule","tags":["Notification Rules"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a notification rule","tags":["Notification Rules"]}},"/v2/notification-rules/{id}/match":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"A sample alert payload (priority, tags, source…)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview which rules match a sample alert","tags":["Notification Rules"]}},"/v2/openapi.json":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"This document, served live by the API","tags":["General"]}},"/v2/postmortem-templates":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List postmortem templates (team-scoped; null teamId = tenant-global)","tags":["Postmortem Templates"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{name, teamId?, sections: [{key, title, prompt?}]}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a postmortem template","tags":["Postmortem Templates"]}},"/v2/postmortem-templates/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a postmortem template (generated postmortems keep their copied sections)","tags":["Postmortem Templates"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a postmortem template","tags":["Postmortem Templates"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Template fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a postmortem template (absent fields unchanged; `teamId: null` clears to tenant-global)","tags":["Postmortem Templates"]}},"/v2/postmortems":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List postmortems","tags":["Postmortems"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Postmortem fields (incidentId, summary, rootCause, timeline, actionItems)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a postmortem for an incident","tags":["Postmortems"]}},"/v2/postmortems/generate":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{incidentId…}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Auto-draft a postmortem from an incident's data","tags":["Postmortems"]}},"/v2/postmortems/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a postmortem","tags":["Postmortems"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a postmortem","tags":["Postmortems"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Postmortem fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a postmortem","tags":["Postmortems"]}},"/v2/postmortems/{id}/export":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Export a postmortem document","tags":["Postmortems"]}},"/v2/pto-requests":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List PTO requests","tags":["Time Off"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"PTO fields (range, reason)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Request time off","tags":["Time Off"]}},"/v2/pto-requests/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Cancel a PTO request","tags":["Time Off"]}},"/v2/pto-requests/{id}/approve":{"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Approve PTO","tags":["Time Off"]}},"/v2/pto-requests/{id}/deny":{"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Deny PTO","tags":["Time Off"]}},"/v2/public/status":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Public incident timeline (`?tenant=\u003ctenantId\u003e`, no auth)","tags":["Status Pages"]}},"/v2/public/status-page/{slug}":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Public status page content","tags":["Status Pages"]}},"/v2/public/status-page/{slug}/history":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Public incident history","tags":["Status Pages"]}},"/v2/public/status-page/{slug}/subscribe":{"post":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Subscribe to status updates","tags":["Status Pages"]}},"/v2/public/status-page/{slug}/unsubscribe":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Unsubscribe (token link)","tags":["Status Pages"]}},"/v2/public/status-page/{slug}/verify":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Confirm a subscription (token link)","tags":["Status Pages"]}},"/v2/push-receipts/{id}":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{token, status}` — a short-lived delivery-bound token and `device_received`, `opened`, or `actioned`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Record app-generated push delivery evidence","tags":["Push Tokens"]}},"/v2/push-tokens":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{token, platform, provider?, deviceType?}` — `deviceType` is `phone` (default) or `watch`; Watch requires APNs+iOS","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Register a device push token","tags":["Push Tokens"]}},"/v2/push-tokens/test":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{priority, delaySeconds?, targetDevice?, identifierMode?}` — self-scoped phone/Watch delivery experiment","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Send a test push to the caller","tags":["Push Tokens"]}},"/v2/push-tokens/{token}":{"delete":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Unregister a push token","tags":["Push Tokens"]}},"/v2/reports/export":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Export report data","tags":["Reports"]}},"/v2/reports/mtta":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mean time-to-acknowledge","tags":["Reports"]}},"/v2/reports/mttr":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mean time-to-resolve","tags":["Reports"]}},"/v2/reports/on-call-hours":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"On-call hours report","tags":["Reports"]}},"/v2/reports/oncall-workload":{"get":{"parameters":[{"description":"Window start; defaults to 30 days before to.","in":"query","name":"from","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Window end; defaults to now. Must follow from by at most 366 days.","in":"query","name":"to","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Narrow both page dispatches and schedule coverage within the caller's team scope.","in":"query","name":"teamId","required":false,"schema":{"type":"string"}},{"description":"CSV exports per-user workload; JSON also includes team aggregates and data-quality caveats.","in":"query","name":"format","required":false,"schema":{"default":"json","enum":["json","csv"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{from,to,definitions,dataQuality,users,teams}` inside the response envelope; drill pages excluded. Counts begin when the dispatch ledger was deployed."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"On-call paging burden, after-hours interruptions and coverage-normalized workload","tags":["Reports"]}},"/v2/reports/responder":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Per-responder load","tags":["Reports"]}},"/v2/reports/schedules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List scheduled report deliveries","tags":["Reports"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Schedule config (report kind, cadence, recipients)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Schedule a recurring report","tags":["Reports"]}},"/v2/reports/schedules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a report schedule","tags":["Reports"]}},"/v2/reports/schedules/{id}/run":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Run a report schedule now","tags":["Reports"]}},"/v2/reports/service":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Per-service alert breakdown","tags":["Reports"]}},"/v2/reports/summary":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Alert volume + MTTR summary","tags":["Reports"]}},"/v2/reports/team":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Per-team alert breakdown","tags":["Reports"]}},"/v2/reports/top-sources":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Top alert sources","tags":["Reports"]}},"/v2/reports/trends":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Alert trend series","tags":["Reports"]}},"/v2/routing-rules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List inbound routing rules","tags":["Routing Rules"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields (matchers, target service/escalation)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a routing rule","tags":["Routing Rules"]}},"/v2/routing-rules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a routing rule","tags":["Routing Rules"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one routing rule","tags":["Routing Rules"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Full rule document","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Replace a routing rule","tags":["Routing Rules"]}},"/v2/saved-searches":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List saved searches","tags":["Saved Searches"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{name, query}`","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Save a search","tags":["Saved Searches"]}},"/v2/saved-searches/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a saved search","tags":["Saved Searches"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rename/update a saved search","tags":["Saved Searches"]}},"/v2/schedules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List on-call schedules (rotations + overrides)","tags":["Schedules"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Schedule fields (name, timezone, teamId, rotations)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a schedule","tags":["Schedules"]}},"/v2/schedules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a schedule","tags":["Schedules"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a schedule","tags":["Schedules"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Schedule fields to change (including nullable teamId)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a schedule","tags":["Schedules"]}},"/v2/schedules/{id}/ical":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Schedule as an iCalendar feed","tags":["Schedules"]}},"/v2/schedules/{id}/notes":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List a schedule's handoff notes (newest first)","tags":["Schedules"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Note fields (text)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add a handoff note to a schedule","tags":["Schedules"]}},"/v2/schedules/{id}/notes/{noteId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"noteId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a handoff note","tags":["Schedules"]}},"/v2/schedules/{id}/on-calls":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Who is on call (now or at a future time)","tags":["Schedules"]}},"/v2/schedules/{id}/overrides":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Override fields (userId, startTime, endTime, reason)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add an on-call override","tags":["Schedules"]}},"/v2/schedules/{id}/overrides/{overrideId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"overrideId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete an override","tags":["Schedules"]}},"/v2/schedules/{id}/rotations":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the schedule's rotations","tags":["Schedules"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rotation fields (name, participants, handoff rules)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add a rotation","tags":["Schedules"]}},"/v2/schedules/{id}/rotations/{rotationId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"rotationId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a rotation","tags":["Schedules"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"rotationId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one rotation","tags":["Schedules"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"rotationId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rotation fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a rotation","tags":["Schedules"]}},"/v2/schedules/{id}/shifts":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Computed shift occurrences","tags":["Schedules"]}},"/v2/schedules/{id}/timeline":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rendered on-call timeline","tags":["Schedules"]}},"/v2/services":{"get":{"parameters":[{"description":"Filter effective health (manual status plus active-alert rollup), not manual status alone. unhealthy means effective status is not ok. Unknown values return 400 VALIDATION.","in":"query","name":"status","required":false,"schema":{"enum":["ok","degraded","down","unhealthy"],"type":"string"}},{"description":"Page size, default 50 and maximum 200.","in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"description":"Opaque nextCursor from the preceding page; exclusive service ID ascending keyset. Malformed or empty cursors return 400 PAGINATION_CURSOR_INVALID. totalCount remains the full matching scope.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"List envelope with full filtered totalCount and optional nextCursor. Tenant/team eligibility and effective health rollup precede filtering and paging; only the returned page is serialized. Omitting status keeps the existing unfiltered scope."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List services (CMDB fields + effective health)","tags":["Services"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Service fields (name, team, escalation policy, …)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a service","tags":["Services"]}},"/v2/services/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a service","tags":["Services"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a service (health rolled up from its alerts)","tags":["Services"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Service fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a service","tags":["Services"]}},"/v2/services/{id}/on-call":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Who is on call for this service right now","tags":["Services"]}},"/v2/services/{id}/owners-suggestion":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Suggested owners for autocomplete","tags":["Services"]}},"/v2/services/{id}/restriction-policy":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the service's effective restriction policy","tags":["Incident Access"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{policyId,backApply:true}","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Irreversibly apply a policy to existing and future linked records","tags":["Incident Access"]}},"/v2/slack/channels":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the workspace channels the bot can see (admin)","tags":["Slack"]}},"/v2/slack/config":{"delete":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Disconnect the Slack integration (admin)","tags":["Slack"]},"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get the tenant's Slack integration config (admin)","tags":["Slack"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Config fields (botToken, appToken, signingSecret, mode, defaultChannelId, namingTemplate, archivePolicy, …)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Save the Slack config (bot/app tokens, channel behavior) (admin)","tags":["Slack"]}},"/v2/slack/config/test":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Test the stored Slack config (admin)","tags":["Slack"]}},"/v2/slack/connection-status":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{mode: socket|http|null, connected, state: connecting|connected|disconnected|configured}` — process-local Socket Mode transport state; HTTP `configured` does not verify delivery and has connected=false"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Slack connection health (admin)","tags":["Slack"]}},"/v2/slack/incidents/{incidentID}/retry-provisioning":{"post":{"parameters":[{"in":"path","name":"incidentID","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Re-enqueue a failed incident-channel provisioning (admin)","tags":["Slack"]}},"/v2/slack/link-code":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{code, expiresInMinutes}` — one-time code valid 10 minutes"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mint the caller's one-time `/opsping link` code (any tenant member)","tags":["Slack"]}},"/v2/slack/manifest":{"get":{"parameters":[{"description":"`yaml` returns `text/yaml` (opsping-slack-manifest.yaml); the default is JSON.","in":"query","name":"format","required":false,"schema":{"enum":["json","yaml"],"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Slack app manifest — JSON by default, `text/yaml` with `?format=yaml`"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rendered tenant-owned Slack app manifest with the tenant's command names (admin)","tags":["Slack"]}},"/v2/slack/oauth-token":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"OAuth token payload from the install flow","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mint a Slack OAuth install link (signed-in user only; API keys 403)","tags":["Slack"]}},"/v2/slack/public/commands":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Slack slash-command entrypoint (signature-verified)","tags":["Slack"]}},"/v2/slack/public/interactions":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Slack interactive-component callback (signature-verified)","tags":["Slack"]}},"/v2/slack/public/oauth/callback":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Slack OAuth install callback","tags":["Slack"]}},"/v2/slack/public/oauth/start":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Begin the Slack OAuth install flow","tags":["Slack"]}},"/v2/slack/public/options":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Slack external-select options callback (signature-verified)","tags":["Slack"]}},"/v2/slack/rules":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List per-tenant Slack channel-routing rules (admin)","tags":["Slack"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields (matchers, channelId)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a Slack routing rule (admin)","tags":["Slack"]}},"/v2/slack/rules/reorder":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{ids}` — rules in the new order","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reorder Slack routing rules (admin)","tags":["Slack"]}},"/v2/slack/rules/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a Slack routing rule (admin)","tags":["Slack"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Rule fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a Slack routing rule (admin)","tags":["Slack"]}},"/v2/slack/usergroups":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List active Slack user groups available for on-call sync (admin)","tags":["Slack"]}},"/v2/slack/usergroups/mappings":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List schedule-to-Slack-user-group mappings (admin)","tags":["Slack"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{scheduleIds:[id,…], usergroupId, mode:primary|all, enabled?}`","required":true},"responses":{"201":{"description":"Mapping created."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Another mapping already manages this Slack user group."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create an on-call user-group mapping (admin)","tags":["Slack"]}},"/v2/slack/usergroups/mappings/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Mapping not found in this tenant."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a mapping without changing Slack group membership (admin)","tags":["Slack"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{scheduleIds?, usergroupId?, mode:primary|all?, enabled?}`; at least one field","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Mapping not found in this tenant."},"409":{"description":"Another mapping already manages this Slack user group."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update an on-call user-group mapping (admin)","tags":["Slack"]}},"/v2/slack/usergroups/mappings/{id}/preview":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{members:[{userId,name,slackUserId}], skipped}` inside the response envelope."},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Mapping not found in this tenant."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview resolved on-call members without writing to Slack (admin)","tags":["Slack"]}},"/v2/slack/usergroups/mappings/{id}/sync":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{status:ok, added, removed, members, skipped}` or `{status:error, code, error}` inside the response envelope."},"400":{"description":"Mapping is disabled."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"Mapping not found in this tenant."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Sync an enabled mapping's on-call roster to Slack now (admin)","tags":["Slack"]}},"/v2/slacklink/confirm":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{token, approveRebind?}","required":true},"responses":{"200":{"description":"`{linked: true, slackIdentity:{displayName, avatarUrl}, avatarImported}`"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"409":{"description":"Slack identity is linked to a different OpsPing user (`REBIND_REQUIRED`, with the identity payloads) — resubmit with `approveRebind: true`."},"410":{"description":"Ticket expired (10-minute TTL)."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Confirm a Slack account-link ticket and link the caller (any tenant member)","tags":["Slack"]}},"/v2/slacklink/ticket":{"get":{"parameters":[{"description":"Link ticket id from the `/opsping link` Slack prompt URL.","in":"query","name":"token","required":false,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"`{state: ok|rebind, slackIdentity:{displayName, realName, avatarUrl, workspaceTeamId}, currentlyLinkedTo?}` — read-only preview"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"410":{"description":"Ticket expired (10-minute TTL)."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Preview a Slack account-link ticket (any tenant member)","tags":["Slack"]}},"/v2/status":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Fleet summary for the authed tenant","tags":["Status Pages"]}},"/v2/status-page":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get this tenant's public status-page config (admin)","tags":["Status Pages"]},"put":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Config fields (slug, visibility, brandName, accentColor, logoUrl, monitors…)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update the status-page config (admin)","tags":["Status Pages"]}},"/v2/status-page/rotate-key":{"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Rotate the secret-link key (admin)","tags":["Status Pages"]}},"/v2/status-page/subscribers":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List email subscribers (admin)","tags":["Status Pages"]}},"/v2/teams":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List teams","tags":["Teams"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Team fields (name, members)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a team","tags":["Teams"]}},"/v2/teams/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a team","tags":["Teams"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a team","tags":["Teams"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Team fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a team","tags":["Teams"]}},"/v2/teams/{id}/members":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List a team's members","tags":["Teams"]},"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"`{userId}` — the user to add","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Add a member","tags":["Teams"]}},"/v2/teams/{id}/members/{userId}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Remove a member","tags":["Teams"]}},"/v2/teams/{teamId}/roles":{"get":{"parameters":[{"in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List the team's custom roles","tags":["Team Roles"]},"post":{"parameters":[{"in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Role fields (name, permissions)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a custom role","tags":["Team Roles"]}},"/v2/teams/{teamId}/roles/{roleId}":{"delete":{"parameters":[{"in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"in":"path","name":"roleId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a custom role","tags":["Team Roles"]},"get":{"parameters":[{"in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"in":"path","name":"roleId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get one custom role","tags":["Team Roles"]},"patch":{"parameters":[{"in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"in":"path","name":"roleId","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Role fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a custom role","tags":["Team Roles"]}},"/v2/tokens":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List API keys","tags":["API Keys"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Key config (name, scopes, integration binding)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Mint an API key (one-time secret reveal)","tags":["API Keys"]}},"/v2/tokens/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Revoke an API key","tags":["API Keys"]}},"/v2/users":{"get":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"List users","tags":["Users"]},"post":{"parameters":[{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"User fields (email, role, permissions)","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Create a user","tags":["Users"]}},"/v2/users/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Delete a user","tags":["Users"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Get a user","tags":["Users"]},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"User fields to change","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Update a user (role, permissions, onboarding)","tags":["Users"]}},"/v2/users/{id}/avatar":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"302":{"description":"Redirect to the fresh Slack avatar URL (snapshots refresh when older than 30 minutes)."},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"404":{"description":"No linked Slack avatar in this tenant — clients render initials."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"302 redirect to the user's current Slack avatar URL (any tenant member)","tags":["Users"]}},"/v2/users/{id}/escalations":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Escalation policies involving the user","tags":["Users"]}},"/v2/users/{id}/mfa/reset":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Reset a user's MFA enrollment (admin)","tags":["Users"]}},"/v2/users/{id}/schedules":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Schedules involving the user","tags":["Users"]}},"/v2/users/{id}/teams":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Compatible-client marker required for restricted content. Does not grant eligibility; current attestation, tenant, team and resource permissions still apply.","in":"header","name":"X-OpsPing-Incident-Access","required":false,"schema":{"enum":["1"],"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"The user's team memberships","tags":["Users"]}},"/v2/webhooks/changes/{provider}/{integrationId}/{token}":{"post":{"parameters":[{"description":"`github` or `gitlab`.","in":"path","name":"provider","required":true,"schema":{"type":"string"}},{"description":"The tenant integration this delivery belongs to.","in":"path","name":"integrationId","required":true,"schema":{"type":"string"}},{"description":"The URL token minted for this integration.","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"The provider's raw event payload. GitHub deliveries are verified against `X-Hub-Signature-256` using the stored `githubSecret`; GitLab deliveries against `X-Gitlab-Token`. The raw body is hashed before verification, so the provider event headers (`X-GitHub-Event` / `X-Gitlab-Event`) select the parser.","required":true},"responses":{"200":{"description":"`{result:'accepted'}` with `202` when a change row was recorded, or `{result:'ignored'}` with `200` for an event the tenant does not track — an ignored event is a success, not an error."},"400":{"description":"Error envelope. `VALIDATION`: the payload could not be parsed as a known provider event."},"401":{"description":"Error envelope. `UNAUTHORIZED`: the URL token did not match the integration, or the provider signature/token check failed. Signature failures are indistinguishable from a bad token so the endpoint cannot be used to probe secrets."},"404":{"description":"Error envelope. `NOT_FOUND`: `provider` is neither `github` nor `gitlab`."},"413":{"description":"Error envelope. `PAYLOAD_TOO_LARGE`: the raw body exceeded the receiver limit."},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Receive GitHub or GitLab deployment and release events","tags":["Inbound Webhooks"]}},"/v2/webhooks/inbound-email/{integrationId}/{token}":{"post":{"parameters":[{"in":"path","name":"integrationId","required":true,"schema":{"type":"string"}},{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Inbound email-ingest webhook (token authorizes)","tags":["Inbound Webhooks"]}},"/v2/webhooks/inbound/{integrationId}/{token}":{"post":{"parameters":[{"in":"path","name":"integrationId","required":true,"schema":{"type":"string"}},{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Inbound webhook ingest (integration token authorizes; OpsGenie-compatible)","tags":["Inbound Webhooks"]}},"/v2/webhooks/twilio/sms":{"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Twilio SMS signal webhook (STOP/START/HELP; X-Twilio-Signature authorizes when configured)","tags":["Inbound Webhooks"]}},"/v2/webhooks/twilio/voice/alert/{token}":{"post":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Signed Twilio interactive real-alert voice action callback","tags":["Inbound Webhooks"]}},"/v2/webhooks/twilio/voice/drill-status/{token}":{"post":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[],"summary":"Signed Twilio call-status callback with opaque recipient correlation","tags":["Inbound Webhooks"]}},"/v2/webhooks/twilio/voice/drill/{token}":{"post":{"parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[],"summary":"Signed Twilio drill voice Ack/Abort action callback","tags":["Inbound Webhooks"]}},"/v2/webhooks/whatsapp":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[],"summary":"Meta webhook verification challenge; requires the configured verification token","tags":["Inbound Webhooks"]},"post":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"},"503":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"FEATURE_AUTHORING_UNAVAILABLE","type":"string"},"message":{"type":"string"}},"required":["message","code"],"type":"object"}}},"description":"FEATURE_AUTHORING_UNAVAILABLE: authoring is closed until signed erasure-aware serving, worker, rollback and recovery baselines are activated. Unknown state fails closed before writes, audit, reservations or provider calls. On shared channel routes this applies only to WhatsApp authoring, not other channel types or pure withdrawal. Signed STOP and existing-drill voice ACK/abort remain available. "}},"security":[],"summary":"Meta signed receipts and correlated actions; raw-body signature and account binding required","tags":["Inbound Webhooks"]}},"/v2/zoom/connection":{"delete":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Disconnect Zoom and delete that user's meeting data","tags":["Zoom"]},"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Read the current user's Zoom connection metadata","tags":["Zoom"]}},"/v2/zoom/oauth/start":{"get":{"parameters":[{"description":"Short-lived `zoom_oauth` JWT for a Slack-originated connect link.","in":"query","name":"token","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[{"ZoomConnectToken":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"summary":"Start Zoom OAuth with short-lived state and PKCE","tags":["Zoom"]}},"/v2/zoom/public/deauthorize":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Zoom deauthorization event payload; `x-zm-signature` and timestamp are required","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Process a signature-verified Zoom deauthorization webhook","tags":["Zoom"]}},"/v2/zoom/public/oauth/callback":{"get":{"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Complete Zoom OAuth and store the encrypted user connection","tags":["Zoom"]}},"/v2/zoom/public/rtms/events":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Zoom RTMS event payload; `x-zm-signature` and timestamp are required. Handles endpoint.url_validation challenges; unknown events and unmatched sessions are acknowledged with 200.","required":true},"responses":{"200":{"description":"Success (list envelope or entity)"},"400":{"description":"Error envelope `{code, message, requestId, took}`"},"401":{"description":"Error envelope `{code, message, requestId, took}`"},"403":{"description":"Error envelope `{code, message, requestId, took}`"},"500":{"description":"Error envelope `{code, message, requestId, took}`"}},"security":[],"summary":"Process signature-verified Zoom RTMS events (meeting.rtms_started / meeting.rtms_stopped)","tags":["Zoom"]}}},"servers":[{"url":"https://api.opsping.com"}]}