Skip to main content
GET
Lister les violations des garde-fous de l’organisation
Pour une vue d’ensemble du fonctionnement des garde-fous et de leur configuration, consultez le guide de la fonctionnalité AI Guardrails.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant à la fois des autorisations ManageEnterpriseSettings et ViewAccountSessions au niveau Enterprise. ViewAccountSessions accorde l’autorisation ViewOrgSessions, que cet endpoint vérifie dans l’organisation cible ; ManageEnterpriseSettings ne suffit pas à elle seule à l’accorder.

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 les 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 tout l’historique disponible (soumis à la pagination).

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

org_id
string
requis

ID de l’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

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).