Saltar al contenido principal
GET
/
v3beta1
/
enterprise
/
guardrail-violations
Listar incumplimientos de límites de seguridad
curl --request GET \
  --url https://api.devin.ai/v3beta1/enterprise/guardrail-violations \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "action_taken": "<string>",
      "confidence_score": 123,
      "created_at": 123,
      "event_id": "<string>",
      "guardrail_id": "<string>",
      "guardrail_name": "<string>",
      "org_id": "<string>",
      "reasoning": "<string>",
      "session_id": "<string>",
      "user_message": "<string>",
      "violation_id": 123
    }
  ],
  "end_cursor": "<string>",
  "has_next_page": false,
  "total": 123
}

Permisos

Se requiere un usuario de servicio con el permiso ManageEnterpriseSettings a nivel de 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 proporcionas time_before, también debes proporcionar time_after.
  • El intervalo de tiempo entre time_after y time_before debe ser de 100 días o menos.
  • Si no se especifican 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 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).