Skip to main content
GET
List Guardrail Violations
For an overview of how guardrails work and how to configure them, see the AI Guardrails feature guide.

Permissions

Requires a service user with the ManageEnterpriseSettings permission at the enterprise level.

Time filters

This endpoint supports optional time filters using the time_after and time_before query parameters.
  • Both time_after and time_before are Unix timestamps in seconds, interpreted as UTC.
  • If you provide time_before, you must also provide time_after.
  • The time range between time_after and time_before must be 100 days or less.
  • If no time filters are provided, the API returns guardrail violations for the full available history (subject to pagination).

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Query Parameters

order
enum<string>
default:desc
Available options:
asc,
desc
time_before
integer | null
time_after
integer | null
after
string | null
first
integer
default:100
Required range: 1 <= x <= 200
session_id
string | null
guardrail_id
string | null

Response

Successful Response

items
GuardrailViolationResponse · object[]
required
end_cursor
string | null

Cursor to fetch the next page, or None if this is the last page.

has_next_page
boolean
default:false

Whether there are more items available after this page.

total
integer | null

Optional total count (can be omitted for performance).