Alert Channels
- GETList active alert channels for the authenticated org
- POSTCreate a new alert channel with encrypted config
- POSTTest alert channel connectivity using raw config (no saved channel required)
- PUTUpdate an alert channel's name and re-encrypt config
- DELSoft-delete an alert channel and return affected policy summary
- GETList delivery history for an alert channel
- POSTTest a saved alert channel's connectivity
API Keys
API Auth
Status Data
- GETList categories with service counts
- GETList all enabled services (cursor-paginated)
- GETList vendor incidents across all services (paginated)
- GETGlobal status summary across all services
- GETGet a single service by slug or UUID with current status, components, and recent incidents
- GETList active components for a service with current status and inline uptime
- GETGet daily uptime data for a component
- GETList incident history for a service (paginated)
- GETGet incident detail with full update timeline
- GETLightweight live-status snapshot for polling
- GETList scheduled maintenances for a service
- GETGet uptime statistics for a service
Dashboard
Deploy Lock
Environments
Incidents
Integrations
Maintenance Windows
Members
Monitors
- GETList monitors for the authenticated org
- POSTCreate a new monitor
- POSTBulk action on monitors
- POSTAd-hoc monitor test
- GETGet a single monitor by id
- PUTUpdate a monitor
- DELSoft-delete a monitor
- POSTPause a monitor (set enabled=false)
- POSTResume a monitor (set enabled=true)
- POSTRotate the ping token for a heartbeat monitor
- GETGet all tags applied to a monitor
- POSTAdd tags to a monitor; supports existing tag IDs and inline creation of new tags
- DELRemove tags from a monitor by their IDs
- POSTTest an existing monitor
- GETList version history for a monitor
- GETGet a specific version snapshot for a monitor
Monitor Alert Channels
Monitor Assertions
Monitor Auth
Notification Dispatches
Notification Policies
- GETList all notification policies for the authenticated org
- POSTCreate a notification policy with match rules and escalation chain
- GETGet a notification policy by ID
- PUTUpdate a notification policy
- DELDelete a notification policy
- GETList all dispatches (firing history) for a notification policy
- POSTDry-run: evaluate a policy's match rules against a supplied incident context
Notifications
Resource Groups
- GETList all resource groups for the authenticated org with health summaries
- POSTCreate a new resource group
- GETGet a resource group by id with member statuses and inherited settings
- PUTUpdate a resource group's name, description, alert policy, inherited settings, and health threshold
- DELDelete a resource group (cascades to member rows)
- GETGet the detailed health breakdown for a resource group
- POSTAdd a monitor or service member to a resource group
- DELRemove a member from a resource group
Service Subscriptions
Tags
Vault
Webhooks
- GETList webhook endpoints for the authenticated org
- POSTRegister a new webhook endpoint
- GETList all available webhook event types
- GETGet signing secret metadata for the authenticated org
- POSTGenerate or rotate the organization webhook signing secret
- GETGet a single webhook endpoint
- PUTUpdate a webhook endpoint
- DELDelete a webhook endpoint
- GETList recent deliveries for a webhook endpoint
- POSTSend a test delivery to a webhook endpoint
Record a heartbeat ping (POST)
curl --request POST \
--url https://api.devhelm.io/api/v1/heartbeat/{token} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '"<string>"'{}Heartbeat
Record a heartbeat ping (POST)
Called by external systems to signal liveness with an optional JSON payload. The payload can be inspected by heartbeat_payload_contains assertions. Always returns 200 OK.
POST
/
api
/
v1
/
heartbeat
/
{token}
Record a heartbeat ping (POST)
curl --request POST \
--url https://api.devhelm.io/api/v1/heartbeat/{token} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '"<string>"'{}⌘I
Assistant
Responses are generated using AI and may contain mistakes.