Saltar al contenido principal
GET
Listar incumplimientos de límites de seguridad de la organización
Para obtener una descripción general de cómo funcionan los guardrails y cómo configurarlos, consulta la guía de AI Guardrails.

Permisos

Requiere un usuario de servicio con el permiso ManageEnterpriseSettings a nivel Enterprise.

Filtros de tiempo

Este endpoint admite filtros de tiempo opcionales mediante los parámetros de consulta time_after y time_before.
  • Tanto time_after como time_before son marcas de tiempo Unix en segundos, interpretadas como UTC.
  • Si se proporciona time_before, también se debe proporcionar time_after.
  • El intervalo de tiempo entre time_after y time_before debe ser de 100 días o menos.
  • Si no se proporcionan filtros de tiempo, la API devuelve violaciones de guardrails para todo el historial disponible (sujeto a paginación).

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de la organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Parámetros de consulta

order
enum<string>
predeterminado:desc
Opciones disponibles:
asc,
desc
time_before
integer | null
time_after
integer | null
after
string | null
first
integer
predeterminado:100
Rango requerido: 1 <= x <= 200
session_id
string | null
guardrail_id
string | null

Respuesta

Respuesta exitosa

items
GuardrailViolationResponse · object[]
requerido
end_cursor
string | null

Cursor para obtener la página siguiente, o None si es la última página.

has_next_page
boolean
predeterminado:false

Indica si hay más elementos disponibles después de esta página.

total
integer | null

Recuento total opcional (puede omitirse por motivos de rendimiento).