Skip to main content
ZStack
Alerting & Response/Alert Routing & Policies

AcknowledgePlatformEvent

Record human attention to one authorized event using the existing unified authentication configuration. When user authentication is optional, requests without a token record Ack and server time with an empty acknowledging user. A verified user identity is recorded when present. Repeated requests preserve the first user and timestamp. Does not resolve the event, alter delivery or acknowledge resource alerts.

POST/api/v1/alerting/platform-events/{uuid}/acknowledge

Operation ID

AcknowledgePlatformEvent

Since

1.3.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • uuid
    StringRequired

    Persisted event record UUID

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Persisted event record UUID

    Example: record-1

  • ackState
    String

    Human attention acknowledgement, Ack after a successful request

    Example: Ack

  • acknowledgedBy
    String

    Stable verified identifier of the first acknowledging user; empty for anonymous acknowledgement when unified user authentication is optional

    Example: user-1

  • acknowledgedAt
    String

    Server timestamp of the first acknowledgement

    Example: 2026-09-20T00:00:00Z