Skip to main content
POST
Resolve alert

Authorizations

X-API-KEY
string
header
required

Project-scoped API key for server-to-server authentication. Obtain keys from the Zenoo dashboard under Project Settings > API Keys. Staging and production environments use separate keys.

Headers

Idempotency-Key
string<uuid>

Unique key for idempotent request handling. If a request with the same key was already processed within the last 24 hours, the original response is returned.

Path Parameters

alert_token
string
required

Alert token.

Body

application/json

Request body for resolving an alert.

action
enum<string>
required

Resolution action.

Available options:
Approve,
Decline,
Escalate,
Request Document,
Approve with Conditions
rationale
string
required

Analyst rationale for the resolution decision. Required for audit trail.

Maximum string length: 5000
is_false_positive
boolean
default:false

Mark this alert as a false positive.

conditions
string

Conditions for conditional approval (required when action is Approve with Conditions).

Maximum string length: 2000

Response

Alert resolved.

Standard response wrapper for all API endpoints. Contains the resource data and pagination metadata.

data
object

A compliance alert requiring analyst review. Alerts are generated automatically when screening checks find matches (PEP, sanctions, adverse media) or when verification checks fail. Each alert has a priority score and SLA deadline.

meta
object