Passer au contenu principal
GET
/
v3beta1
/
enterprise
/
guardrail-violations
Lister les violations des garde-fous
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
}

Permissions

Nécessite un compte de service disposant de l’autorisation ManageEnterpriseSettings au niveau de l’Enterprise.

Filtres temporels

Cet endpoint prend en charge des filtres temporels optionnels via les paramètres de requête time_after et time_before.
  • time_after et time_before sont tous deux des horodatages Unix en secondes, interprétés en UTC.
  • Si vous fournissez time_before, vous devez également fournir time_after.
  • L’intervalle de temps entre time_after et time_before doit être de 100 jours ou moins.
  • Si aucun filtre temporel n’est fourni, l’API renvoie les violations des garde‑fous pour l’intégralité de l’historique disponible (sous réserve de pagination).

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de requête

order
enum<string>
défaut:desc
Options disponibles:
asc,
desc
time_before
integer | null
time_after
integer | null
after
string | null
first
integer
défaut:100
Plage requise: 1 <= x <= 200
session_id
string | null
guardrail_id
string | null

Réponse

Réponse réussie

items
GuardrailViolationResponse · object[]
requis
end_cursor
string | null

Curseur pour récupérer la page suivante, ou None s’il s’agit de la dernière page.

has_next_page
boolean
défaut:false

Indique s’il existe d’autres éléments après cette page.

total
integer | null

Nombre total d’éléments facultatif (peut être omis pour des raisons de performance).