> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Listar violações de guardrail
> Listar violações de guardrail em todo o ambiente Enterprise.
Para ver uma visão geral de como os guardrails funcionam e como configurá-los, consulte o guia do recurso [AI Guardrails](/pt-BR/enterprise/features/ai-guardrails).
## Permissões
Requer um usuário de serviço com a permissão `ManageEnterpriseSettings` no nível da Enterprise.
## Filtros de tempo
Este endpoint é compatível com filtros de tempo opcionais usando os parâmetros de consulta `time_after` e `time_before`.
* Tanto `time_after` quanto `time_before` são **carimbos de data e hora Unix em segundos**, interpretados como UTC.
* Se você informar `time_before`, também deverá informar `time_after`.
* O intervalo de tempo entre `time_after` e `time_before` deve ser de **100 dias ou menos**.
* Se nenhum filtro de tempo for especificado, a API retorna violações de guardrail para todo o histórico disponível (sujeito à paginação).
## OpenAPI
````yaml pt-BR/v3-openapi.yaml GET /v3beta1/enterprise/guardrail-violations
openapi: 3.1.0
info:
description: API Devin v3 com autenticação de usuário de serviço e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3beta1/enterprise/guardrail-violations:
get:
tags:
- guardrail_violations
summary: Listar violações de guardrail
description: Listar violações de guardrail em todo o ambiente Enterprise.
operationId: >-
handle_get_enterprise_guardrail_violations_v3beta1_enterprise_guardrail_violations_get
parameters:
- in: query
name: order
required: false
schema:
default: desc
enum:
- asc
- desc
title: Order
type: string
- in: query
name: time_before
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time Before
- in: query
name: time_after
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time After
- in: query
name: after
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- in: query
name: first
required: false
schema:
default: 100
maximum: 200
minimum: 1
title: First
type: integer
- in: query
name: session_id
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Session Id
- in: query
name: guardrail_id
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Guardrail Id
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/PaginatedResponse_GuardrailViolationResponse_
description: Resposta bem-sucedida
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Não autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Proibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Não encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflito
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conteúdo não processável
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Muitas requisições
components:
schemas:
PaginatedResponse_GuardrailViolationResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor para obter a próxima página ou None se esta for a última
página.
title: End Cursor
has_next_page:
default: false
description: Indica se há mais itens disponíveis após esta página.
title: Has Next Page
type: boolean
items:
items:
$ref: '#/components/schemas/GuardrailViolationResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: >-
Contagem total opcional (pode ser omitida por motivos de
desempenho).
title: Total
required:
- items
title: PaginatedResponse[GuardrailViolationResponse]
type: object
ProblemDetail:
description: >-
Corpo de erro RFC 9457 application/problem+json da API v3.
detail é mantido do corpo legado {"detail": ...} por
retrocompatibilidade; os
outros membros são aditivos. errors contém falhas de validação em nível
de campo
(apenas 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Uma explicação legível por humanos específica para esta ocorrência.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erros de validação no nível do campo (apenas respostas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: >-
Uma referência de URI (o caminho da requisição) para esta
ocorrência.
title: Instance
status:
description: O código de status HTTP.
title: Status
type: integer
title:
description: Um breve resumo do tipo de problema, legível para humanos.
title: Title
type: string
type:
default: about:blank
description: Uma referência de URI que identifica o tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
GuardrailViolationResponse:
properties:
action_taken:
title: Action Taken
type: string
confidence_score:
title: Confidence Score
type: number
created_at:
title: Created At
type: integer
event_id:
title: Event Id
type: string
guardrail_id:
title: Guardrail Id
type: string
guardrail_name:
title: Guardrail Name
type: string
org_id:
title: Org Id
type: string
reasoning:
title: Reasoning
type: string
session_id:
anyOf:
- type: string
- type: 'null'
title: Session Id
user_message:
title: User Message
type: string
violation_id:
title: Violation Id
type: integer
required:
- violation_id
- org_id
- session_id
- event_id
- guardrail_id
- guardrail_name
- confidence_score
- action_taken
- reasoning
- user_message
- created_at
title: GuardrailViolationResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuário de serviço (prefixo: cog_)'
scheme: bearer
type: http
````