ingestion

Push a custom incident (PagerDuty Events v2 envelope)

Agent-detected incident. Action-based state machine: trigger opens or updates, acknowledge marks, resolve closes. Deduplicated on (user_id, dedup_key) — same key merges into one incident.

post/api/v1/incidents

Request

  • Base URL: https://monit.rs
  • URL: https://monit.rs/api/v1/incidents
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional. Same key + same body replays cached response for 24h; same key + different body returns 409.

Request body

action'trigger' | 'acknowledge' | 'resolve' required
dedup_keystring required

Merges trigger/ack/resolve events into one incident (PagerDuty pattern).

endpoint_idstring uuid nullable

Required on trigger; optional on ack/resolve.

external_refstring nullable

Free-form caller-side reference (e.g. ticket number).

Response

Incident created or updated.

incident_idstring uuid required
dedup_keystring required
status'open' | 'acknowledged' | 'resolved' required

Changes

No recorded changes to this operation across all 1 revision of this API.