> ## Documentation Index
> Fetch the complete documentation index at: https://developers.govworx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive incident updates from GovWorx

> Receive incident updates from GovWorx at a CAD-hosted endpoint.

# Receive incident updates from GovWorx

GovWorx sends updates to an HTTPS endpoint that the CAD system hosts. An update can add
information to an existing record or carry data that has no CAD incident yet.

GovWorx sends an update whenever it has relevant data for an authorized listener. When a customer
has more than one authorized listener, GovWorx delivers the update to each one. The update may
have a CAD incident identifier, a GovWorx correlation identifier, or both. Some update types can
arrive before either association exists.

Each listener receives and acknowledges its delivery independently. A slow, failed, or
incompatible listener does not delay or suppress delivery to another listener.

The endpoint acknowledges that it received a delivery. Receipt does not by itself mean the CAD
applied the update. A connector profile identifies which updates and fields the CAD supports, and
whether it can confirm application.

## Update an existing CAD incident

Once CAD has an incident identifier, GovWorx can deliver information for that record. The initial
update types are below.

<CardGroup cols={2}>
  <Card title="Call type" icon="phone">
    A recommended call type, discipline, and priority.
  </Card>

  <Card title="Comment" icon="comment">
    Narrative information for the incident.
  </Card>

  <Card title="Dispatch recommendation" icon="truck-medical">
    A recommended set of resources for the incident.
  </Card>

  <Card title="Completed interaction" icon="flag-checkered">
    Completion information and the interaction transcript.
  </Card>
</CardGroup>

GovWorx can also share broader incident changes when an integration supports them. The public
contract for those changes defines their fields and application behavior.

## Receive a delivery

<Steps>
  <Step title="Verify the delivery">
    Verify the configured credential and signature before parsing the body. See
    [Authentication](/connections-platform/authentication).
  </Step>

  <Step title="Check the delivery identifier">
    Recognize a retry before applying the same update again. See
    [Reliability](/connections-platform/reliability).
  </Step>

  <Step title="Queue or apply the update">
    Apply supported fields, or queue the delivery for CAD processing. The connector profile
    defines what the CAD can represent and confirm.
  </Step>

  <Step title="Acknowledge receipt">
    Return the configured acknowledgement. A successful acknowledgement confirms receipt unless
    the connector profile explicitly provides application confirmation.
  </Step>
</Steps>

## Reference

The CAD API reference contains the delivery envelopes, headers, acknowledgements, and schemas.

<Card title="Receive incident updates from GovWorx" icon="book" href="/connections-platform/api-reference/receive-incident-updates-from-govworx/receive-a-call-type-update" horizontal>
  Review the complete webhook contract while implementing the endpoint.
</Card>