Declare an emergency
Required permission: write.
Forwarded to the shared EmergencyDeclarationUsecase so Notify and v1 share
a single implementation. Idempotency-Key handling is on the roadmap — for
now, retries on a transient failure may create duplicate emergencies.
Partners that want dedup today can supply externalId (unique per org).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Target organization id (from the route path)
Body
Partner-supplied incident id from the caller's own system; indexed, surfaced on reads + webhooks.
1 - 2561282000Response
Successful Response
Minimal category info embedded on emergencies + webhook payloads.
Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.
Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.