Skip to main content
POST
Acknowledge or reopen an alert-id

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

Authorization
string

Bearer JWT token. The operator identity recorded on the event is derived from THIS token, never the body.

Body

application/json

Acknowledge or reopen an opaque alert-id.

action
enum<string>
required

'acknowledge' marks the alert handled; 'reopen' flips it back to open.

Available options:
acknowledge,
reopen
Example:

"acknowledge"

alertId
string
required

Opaque client alert identity (kind:subject).

Example:

"projected-floor-breach"

note
string

Optional operator handoff note (≤500 chars).

Response

Created

alertId
string
required

Opaque client alert identity (kind:subject).

Example:

"projected-floor-breach"

at
string<date-time>
required

When the latest event was recorded (RFC 3339).

operator
object
required

Server-extracted operator who recorded the latest event.

state
string
required

'acknowledged' or 'open' (open = latest event was a reopen).

Example:

"acknowledged"

note
string

Optional operator-authored handoff note.

Example:

"called BACEN, awaiting callback"