Skip to main content

Acknowledge a Signals raw alert

MethodPath
POST/v1/signals/raw-alerts/:alertId/ack

Shared authentication, project scope, and response conventions.

Acknowledges and resolves one individual alert. A later breaching reading can create another alert. Unlike episode acknowledgement, this route works when episodicAlerts is off.

Requirement or resultDetails
Access policysignals_alerts:update and Patient update
Caller profileA person profile is required and recorded as acknowledgedActor.
RequestNo body. :alertId is the Signals alert id.
Success200 with the updated raw alert and noteCount: null.
IdempotencyA previously acknowledged alert remains acknowledged; Ovok records the repeated call and returns the existing alert.
curl --request POST \
--url 'https://api.sandbox.ovok.com/v1/signals/raw-alerts/7c2e9a4b-1f3d-4b8e-a6c5-2d9f0e1b3a7c/ack' \
--header "Authorization: Bearer ${OVOK_TOKEN}"
StatusMeaning
403Missing signals_alerts:update, Patient update access, or person profile.
404Alert is missing, outside the project, or tied to an unreadable Patient.
409Another acknowledgement for this alert is running.
503 signals_audit_failedThe audit record could not be created, so the acknowledgement was not sent. Retrying is safe.