Acknowledge an operational alert
Records that an operator saw alert and deactivates it, so it leaves the default (active-only) feed; it remains readable with activeOnly=false. The dismissal, its acknowledgement event and its audit row commit together. EVERY alert type is acknowledgeable, including the condition alarms (RELAY_DOWN, CONNECTION_DOWN, CERTIFICATE_EXPIRY, WINDOW_CLOSING): acknowledging asserts that a person saw the alarm, never that the condition ended, so while the condition holds the watcher’s next poll raises a FRESH alert and it reappears. An unknown id is 404; an alert another operator already acknowledged (or that cleared itself) is 409, never a silent success. The response omits complementWindowClosesAt: the dismissal reads the alert row alone and performs no recálculo join.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key for this state-changing request (required, max 255 characters).
255Request correlation identifier. Generated when omitted.
Parámetros de ruta
The alert to acknowledge.
Cuerpo
Optional operator note recorded with the acknowledgement (≤500 characters).
500Respuesta
OK
Whether the alert is active. false appears only when activeOnly=false surfaces deactivated (history) alerts.
Alert id; the opaque key consumers address the alert by — acknowledgeAlert on this rail — and correlate to the alert.{raised,cleared,acknowledged} facts.
Alert raise instant.
Alert type.
WINDOW_CLOSING, RECALCULATION, RELAY_DOWN, CERTIFICATE_EXPIRY, CONNECTION_DOWN, SCHEDULE_CHANGE, CAMARA_INTERRUPTED, CAMARA_CLOSED, COLLATERAL_REQUIRED, COLLATERAL_SUBSTITUTION, ELIGIBLE_ASSETS_CHANGED, INBOUND_QUARANTINED, FOREIGN_TENANT_COMMAND, INBOUND_SEMANTIC_REJECTED, OUTBOUND_DISPATCHER_DOWN, UNANSWERED_REQUEST, OT_REPLAY_DOWN, XSD_VALIDATOR_DOWN For a RECALCULATION alert whose cycle holds an active recálculo round, the round's complement/deposit deadline, projected verbatim from ot_recalculations.complement_window_closes_at; omitted otherwise.
Correlated cycle id; omitted for a connection-level alert (e.g. RELAY_DOWN).
Absolute deadline this alert tracks (e.g. a WINDOW_CLOSING deposit close or a CERTIFICATE_EXPIRY not-after), projected verbatim from alerts.deadline_at; omitted when the stored column is NULL.
Structured payload of an accumulating alarm, projected verbatim from alerts.details; omitted when the stored column is NULL. A FOREIGN_TENANT_COMMAND alert keeps ONE row for a whole episode and carries count and lastTenantId here, so this is the only place the size of that episode is visible. An UNANSWERED_REQUEST alert carries the request it names: outboundMessageId, codMsg, numCtrlIf and dispatchedAt; the deadline that was crossed is deadlineAt.
Operator-facing alert message; omitted when the stored message is empty.

