> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Acknowledge an operational alert > Records that an operator saw alert {id} 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. ## OpenAPI ````yaml /en/openapi/v3-current/siloc.yaml post /api/v1/siloc/alerts/{id}/acknowledge openapi: 3.1.0 info: description: >- OpenAPI 3.1 surface for Lerian SILOC, the participant-side rail connecting the institution to Núclea's SILOC deferred-net interbank settlement. title: Lerian SILOC API version: 1.0.0 servers: - url: https://siloc.sandbox.lerian.net security: [] paths: /api/v1/siloc/alerts/{id}/acknowledge: post: tags: - Alerts summary: Acknowledge an operational alert description: >- Records that an operator saw alert {id} 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. operationId: acknowledgeAlert parameters: - description: >- Idempotency key for this state-changing request (required, max 255 characters). in: header name: X-Idempotency required: true schema: description: >- Idempotency key for this state-changing request (required, max 255 characters). maxLength: 255 type: string - description: Request correlation identifier. Generated when omitted. in: header name: X-Request-ID schema: description: Request correlation identifier. Generated when omitted. type: string - description: The alert to acknowledge. in: path name: id required: true schema: description: The alert to acknowledge. format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/AcknowledgeAlertInputBody' responses: '200': content: application/json: schema: $ref: '#/components/schemas/AlertResponse' description: OK '422': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Unprocessable Entity '500': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Internal Server Error default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: AcknowledgeAlertInputBody: additionalProperties: false properties: note: description: >- Optional operator note recorded with the acknowledgement (≤500 characters). maxLength: 500 type: string type: object AlertResponse: additionalProperties: false properties: active: description: >- Whether the alert is active. false appears only when activeOnly=false surfaces deactivated (history) alerts. type: boolean complementWindowClosesAt: description: >- 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. format: date-time type: string cycleId: description: >- Correlated cycle id; omitted for a connection-level alert (e.g. RELAY_DOWN). format: uuid type: string deadlineAt: description: >- 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. format: date-time type: string details: description: >- 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. id: description: >- Alert id; the opaque key consumers address the alert by — acknowledgeAlert on this rail — and correlate to the alert.{raised,cleared,acknowledged} facts. format: uuid type: string message: description: >- Operator-facing alert message; omitted when the stored message is empty. type: string raisedAt: description: Alert raise instant. format: date-time type: string type: description: Alert type. enum: - 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 type: string required: - id - type - raisedAt - active type: object Detail: additionalProperties: true properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````