State (ongoing incidents)
Feed State models ongoing incidents with an immutable eventId
. You can repeatedly upsert updates to the same eventId
until it is resolved.
Endpoints
- Upsert state (public):
POST /open/feed/{channelId}/state/upsert
- Resolve state (auth):
POST /open/workspace/{workspaceId}/feed/{channelId}/state/resolve
- List ongoing states (auth):
GET /open/workspace/{workspaceId}/feed/state/all?channelId=...&limit=...
Upsert body
{
"eventId": "deploy#2025-08-12",
"eventName": "deploy_progress",
"eventContent": "Rollout 60%",
"tags": ["prod"],
"source": "ci",
"senderId": "runner-42",
"senderName": "GitHub Actions",
"important": true,
"payload": {"stage": "canary"}
}
If the channel is configured with webhookSignature
, you must include header x-webhook-signature
.
Resolve example
curl -X POST \
"$BASE_URL/workspace/$WORKSPACE_ID/feed/$CHANNEL_ID/state/resolve" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"stateId": "STATE_ID"}'