Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions docs/openapi/monitoring-api.json
Original file line number Diff line number Diff line change
Expand Up @@ -13234,7 +13234,7 @@
"Service Subscriptions"
],
"summary": "Update alert sensitivity for a subscription",
"description": "Controls which external incidents trigger alerts: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, default), MAJOR_ONLY (only DOWN-level incidents).",
"description": "Controls which external incidents trigger alerts and whether they page anyone: ALL (any status change, paged), INCIDENTS_ONLY (real vendor incidents, paged), MAJOR_ONLY (only DOWN-level incidents, paged), AWARENESS (real vendor incidents tracked silently — visible on the dashboard but no alert channels fire; default for new subscriptions).",
"operationId": "updateAlertSensitivity",
"parameters": [
{
Expand Down Expand Up @@ -13357,7 +13357,7 @@
"Service Subscriptions"
],
"summary": "Subscribe to a service or a component of a service",
"description": "Idempotent — returns the existing subscription if an identical one exists. Omit the request body or set componentId to null for a whole-service subscription. Free tier: max 10 subscriptions. Paid tier: unlimited.",
"description": "Idempotent — returns the existing subscription if an identical one exists. Omit the request body or set componentId to null for a whole-service subscription. When alertSensitivity is omitted, new subscriptions default to AWARENESS (silent tracking — the incident appears on the dashboard but no alert channels fire). PATCH /alert-sensitivity to opt in to paging. Free tier: max 10 subscriptions. Paid tier: unlimited.",
"operationId": "subscribe_1",
"parameters": [
{
Expand Down Expand Up @@ -29880,8 +29880,9 @@
"nullable": true
},
"alertSensitivity": {
"pattern": "ALL|AWARENESS|INCIDENTS_ONLY|MAJOR_ONLY",
"type": "string",
"description": "Alert sensitivity level. Defaults to INCIDENTS_ONLY when not provided.",
"description": "Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, page on every one), MAJOR_ONLY (only DOWN-level incidents), AWARENESS (track silently — show on dashboard, never send alerts). Defaults to AWARENESS when not provided — silent tracking is the friendliest first-run choice; switch to one of the paging modes to opt in to alert-channel fan-out.",
"nullable": true
}
},
Expand Down Expand Up @@ -29965,9 +29966,10 @@
"alertSensitivity": {
"minLength": 1,
"type": "string",
"description": "Alert sensitivity: ALL (synthetic + real incidents), INCIDENTS_ONLY (real vendor incidents, default), MAJOR_ONLY (real + DOWN severity)",
"description": "Alert sensitivity: ALL (synthetic + real incidents, paged), INCIDENTS_ONLY (real vendor incidents, paged), MAJOR_ONLY (real + DOWN severity, paged), AWARENESS (real vendor incidents tracked silently — visible on dashboard, never paged; default for new subscriptions)",
"enum": [
"ALL",
"AWARENESS",
"INCIDENTS_ONLY",
"MAJOR_ONLY"
]
Expand Down Expand Up @@ -33174,9 +33176,9 @@
"properties": {
"alertSensitivity": {
"minLength": 1,
"pattern": "ALL|INCIDENTS_ONLY|MAJOR_ONLY",
"pattern": "ALL|AWARENESS|INCIDENTS_ONLY|MAJOR_ONLY",
"type": "string",
"description": "Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, default), MAJOR_ONLY (only DOWN-level incidents)"
"description": "Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, page on every one), MAJOR_ONLY (only DOWN-level incidents), AWARENESS (track silently — show on dashboard, never send alerts; default for new subscriptions)"
}
},
"description": "Request body for updating alert sensitivity on a service subscription"
Expand Down
9 changes: 5 additions & 4 deletions src/devhelm/_generated.py
Original file line number Diff line number Diff line change
Expand Up @@ -4042,7 +4042,8 @@ class ServiceSubscribeRequest(BaseModel):
str | None,
Field(
alias="alertSensitivity",
description="Alert sensitivity level. Defaults to INCIDENTS_ONLY when not provided.",
description="Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, page on every one), MAJOR_ONLY (only DOWN-level incidents), AWARENESS (track silently — show on dashboard, never send alerts). Defaults to AWARENESS when not provided — silent tracking is the friendliest first-run choice; switch to one of the paging modes to opt in to alert-channel fan-out.",
pattern="ALL|AWARENESS|INCIDENTS_ONLY|MAJOR_ONLY",
),
] = None

Expand Down Expand Up @@ -4086,7 +4087,7 @@ class ServiceSubscriptionDto(BaseModel):
str,
Field(
alias="alertSensitivity",
description="Alert sensitivity: ALL (synthetic + real incidents), INCIDENTS_ONLY (real vendor incidents, default), MAJOR_ONLY (real + DOWN severity)",
description="Alert sensitivity: ALL (synthetic + real incidents, paged), INCIDENTS_ONLY (real vendor incidents, paged), MAJOR_ONLY (real + DOWN severity, paged), AWARENESS (real vendor incidents tracked silently — visible on dashboard, never paged; default for new subscriptions)",
min_length=1,
),
]
Expand Down Expand Up @@ -5090,9 +5091,9 @@ class UpdateAlertSensitivityRequest(BaseModel):
str,
Field(
alias="alertSensitivity",
description="Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, default), MAJOR_ONLY (only DOWN-level incidents)",
description="Alert sensitivity: ALL (any status change), INCIDENTS_ONLY (real vendor incidents, page on every one), MAJOR_ONLY (only DOWN-level incidents), AWARENESS (track silently — show on dashboard, never send alerts; default for new subscriptions)",
min_length=1,
pattern="ALL|INCIDENTS_ONLY|MAJOR_ONLY",
pattern="ALL|AWARENESS|INCIDENTS_ONLY|MAJOR_ONLY",
),
]

Expand Down