{
"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."
}Publish an incident event
Accepts activity for an actual or potential incident. Providers can send a strongly typed NENA EIDO state snapshot, a strongly typed incident-lifecycle event, or an encoded native payload for a connector to map into EIDO. The API key determines the tenant; the envelope tenant must match it. A successful response means the submission was validated and durably persisted.
{
"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
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
- Strongly typed NENA EIDO submission
- Strongly typed incident-lifecycle submission
- Encoded vendor-native incident submission
Must match the tenant resolved from the API key.
x >= 1Stable 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.
1 - 100Identifies the payload as a NENA EIDO JSON object.
"nena-eido"NENA EIDO structure version. GovWorx validates against the pinned NENA OpenAPI schema release 1.0.1.
"1.0"Time the vendor created the envelope.
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.
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.
^[a-f0-9]{64}$"accepted"GovWorx receipt time.
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.
^[a-f0-9]{64}$
