v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB

Security Insights

Update an insight

Update the status of an insight for a specific domain.

put/waap/v1/domains/{domain_id}/insights/{insight_id}

Path parameters

domain_idinteger required

The domain ID

insight_idstring uuid required

The ID of the insight

Request body

status'OPEN' | 'ACKED' | 'CLOSED' required

The different statuses an insight can have

Response

Successful Response

idstring uuid required

A generated unique identifier for the insight

insight_typestring required

The slug of the insight type

labelsobject required

A hash table of label names and values that apply to the insight

first_seenstring date-time required

The date and time the insight was first seen in ISO 8601 format

last_seenstring date-time required

The date and time the insight was last seen in ISO 8601 format

last_status_changestring date-time required

The date and time the insight was last seen in ISO 8601 format

status'OPEN' | 'ACKED' | 'CLOSED' required

The different statuses an insight can have

descriptionstring required

The description of the insight

recommendationstring required

The recommended action to perform to resolve the insight

Example response

{
  "description": "A request originated from a high-risk IP: 1.2.3.4, but it was allowed by rule: 'my custom rule' the description of the insight",
  "recommendation": "disable or delete rule \"my-custom-rule\""
}