Publish an incident event

curl --request POST \
  --url https://api.example.com/cad/v1/incidents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenantId": 12345,
  "provider": "primary-cad-interface",
  "format": "govworx-incident-lifecycle",
  "format_version": "1.0",
  "timestamp": "2026-08-26T20:14:31Z",
  "data": {
    "eventType": "incident.linked",
    "correlationId": "interaction-456",
    "cadIncidentId": "CAD-12345"
  }
}
'

{
  "submissionId": "6c99a1a89bb598e95f412dc144b95f47de57fca9878f4a225b58180bde1775a2",
  "eventId": "82c5830851a0d02c4000e85d734c726f50518cf3e051454a51a3555dd8aece77",
  "status": "accepted",
  "timestamp": "2026-08-26T20:14:32Z"
}

{
  "code": "invalid_request",
  "message": "The request contains invalid fields.",
  "details": [
    {
      "field": "format",
      "message": "Must be nena-eido, govworx-incident-lifecycle, or vendor-native."
    }
  ]
}

{
  "code": "unauthorized",
  "message": "Authentication is required."
}

POST

cad

incidents

curl --request POST \
  --url https://api.example.com/cad/v1/incidents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenantId": 12345,
  "provider": "primary-cad-interface",
  "format": "govworx-incident-lifecycle",
  "format_version": "1.0",
  "timestamp": "2026-08-26T20:14:31Z",
  "data": {
    "eventType": "incident.linked",
    "correlationId": "interaction-456",
    "cadIncidentId": "CAD-12345"
  }
}
'

{
  "submissionId": "6c99a1a89bb598e95f412dc144b95f47de57fca9878f4a225b58180bde1775a2",
  "eventId": "82c5830851a0d02c4000e85d734c726f50518cf3e051454a51a3555dd8aece77",
  "status": "accepted",
  "timestamp": "2026-08-26T20:14:32Z"
}

{
  "code": "invalid_request",
  "message": "The request contains invalid fields.",
  "details": [
    {
      "field": "format",
      "message": "Must be nena-eido, govworx-incident-lifecycle, or vendor-native."
    }
  ]
}

{
  "code": "unauthorized",
  "message": "Authentication is required."
}

Authorizations

Authorization

string

header

required

Administratively provisioned per-tenant API key for vendor incident submissions. Send it as Authorization: Bearer <tenant-api-key>. Version 1 does not require an OAuth exchange or token endpoint.

Body

application/json

Strongly typed NENA EIDO submission
Strongly typed incident-lifecycle submission
Encoded vendor-native incident submission

tenantId

integer<int64>

required

Must match the tenant resolved from the API key.

Required range: x >= 1

provider

string

required

Stable identifier for the submitting CAD interface, system, or vendor implementation. It identifies the payload producer; format and format_version separately identify the payload contract. The value must match a provider supported by the tenant's configured CAD connection, such as primary-cad-interface or regional-cad-feed.

Required string length: 1 - 100

format

string

required

Identifies the payload as a NENA EIDO JSON object.

Allowed value: "nena-eido"

format_version

string

required

NENA EIDO structure version. GovWorx validates against the pinned NENA OpenAPI schema release 1.0.1.

Allowed value: "1.0"

timestamp

string<date-time>

required

Time the vendor created the envelope.

data

NENA EIDO object · object

required

Opaque rendering of a complete NENA (National Emergency Number Association) EIDO 1.0 object. GovWorx validates this value against the pinned NENA EIDO 1.0.1 normative schema linked in externalDocs. GovWorx adopts NENA schema updates through a published contract revision. Do not use this rendered OpenAPI schema for client-side EIDO validation.

Response

The incident submission was accepted and durably persisted.

submissionId

string

required

Lowercase hexadecimal SHA-256 digest of the exact request-body bytes received after HTTP content decoding. A byte-identical retry returns the same submission identifier even when the submission represents a lifecycle transition rather than a normalized incident event.

Pattern: ^[a-f0-9]{64}$

status

string

required

Allowed value: "accepted"

timestamp

string<date-time>

required

GovWorx receipt time.

eventId

string

Identifier of the normalized incident event produced by this submission. Omitted when the submission only records a pre-bind lifecycle transition or otherwise produces no normalized event.

Pattern: ^[a-f0-9]{64}$

CAD integration

CAD API reference

Authorizations

Body

Response