Skip to main content
POST
Declare an emergency

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org_id
string
required

Target organization id (from the route path)

Body

application/json
externalId
string | null

Partner-supplied incident id from the caller's own system; indexed, surfaced on reads + webhooks.

Required string length: 1 - 256
categoryId
string | null
categoryName
string | null
source
string | null
Maximum string length: 128
description
string | null
Maximum string length: 2000
occurredAt
string | null
location
PublicLocationInput · object | null
metadata
Metadata · object | null
declaredBy
DeclareEmergencyDeclaredBy · object | null

Response

Successful Response

emergencyId
string
required
orgId
string
required
status
string
required
externalId
string | null
category
PublicCategoryRef · object | null

Minimal category info embedded on emergencies + webhook payloads.

source
string | null
description
string | null
occurredAt
string | null
createdAt
string | null
resolvedAt
string | null
resolvedBy
PublicActorRef · object | null

Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.

declaredBy
PublicActorRef · object | null

Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.

location
PublicLocation · object | null
resolutionNote
string | null
metadata
Metadata · object | null