> ## 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 varreduras de código (API do Devin)
> Liste as varreduras de código do Devin em uma Enterprise e consulte o status delas, com filtros por tempo, repositório e organização pela API v3
## Permissões
É necessário ter um [usuário de serviço](/pt-BR/api-reference/v3/service-users/members-service-users) ou [token de acesso pessoal](/pt-BR/api-reference/personal-access-tokens) com a permissão `ViewAccountCodeScans` no nível Enterprise.
## Comportamento
Retorna as varreduras de código de toda a Enterprise, das mais recentes às mais antigas. Use este endpoint para consultar o `status` de uma varredura iniciada com [Iniciar varredura de código](/pt-BR/api-reference/v3/code-scans/enterprise-code-scans-start): `waiting` → `pending` → `running` → `completed` (ou `failed` / `cancelled`). `awaiting_user_input` aplica-se apenas a varreduras interativas iniciadas pelo app web; varreduras iniciadas pela API não entram nesse estado.
### Filtros
* `time_after` / `time_before`: timestamps Unix em segundos (UTC) que delimitam o momento de criação da varredura.
* `repo_name`: somente varreduras que analisaram este repositório. Também corresponde a varreduras de vários repositórios que o incluem.
* `org_ids`: somente varreduras destas organizações.
Os resultados são paginados com um cursor opaco (`after` / `first`). Para uma única organização, use [Listar varreduras de código (Organization)](/pt-BR/api-reference/v3/code-scans/organizations-code-scans-list).
## OpenAPI
````yaml pt-BR/v3-openapi.yaml GET /v3/enterprise/code-scans/scans
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:
/v3/enterprise/code-scans/scans:
get:
tags:
- code-scans
summary: Listar varreduras de código
description: >-
Liste as varreduras de código da conta Enterprise.
As varreduras são retornadas da mais recente para a mais antiga.
Opcionalmente, filtre por ``org_ids``, ``repo_name`` e hora de criação
(``time_after`` / ``time_before``); os resultados são paginados com um
cursor opaco (``after`` / ``first``).
operationId: handle_list_code_scans_v3_enterprise_code_scans_scans_get
parameters:
- 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
- description: >-
Filtre para varreduras que analisaram este repositório. Inclui
correspondências com varreduras de vários repositórios, mesmo quando
o repositório não é o principal da varredura; por isso, os itens
retornados podem informar um ``repo_name`` diferente.
in: query
name: repo_name
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
Filtre para varreduras que analisaram este repositório. Inclui
correspondências com varreduras de vários repositórios, mesmo
quando o repositório não é o principal da varredura; por isso, os
itens retornados podem informar um ``repo_name`` diferente.
title: Repo Name
- description: Filtre para varreduras nestas organizações.
in: query
name: org_ids
required: false
schema:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Filtre para varreduras nestas organizações.
title: Org Ids
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_CodeScanResponse_'
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: Solicitações em excesso
components:
schemas:
PaginatedResponse_CodeScanResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor para buscar 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/CodeScanResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: Contagem total opcional (pode ser omitida por desempenho).
title: Total
required:
- items
title: PaginatedResponse[CodeScanResponse]
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
CodeScanResponse:
description: Uma única varredura de código.
properties:
created_at:
description: Quando a varredura foi criada (segundos Unix).
title: Created At
type: integer
host:
anyOf:
- type: string
- type: 'null'
description: Host Git do repositório, se conhecido.
title: Host
org_id:
description: Organização à qual a varredura pertence.
title: Org Id
type: string
profile:
anyOf:
- $ref: '#/components/schemas/CodeScanProfileResponse'
- type: 'null'
description: Perfil sob o qual a varredura foi executada, se houver.
repo_name:
description: >-
Repositório principal da varredura. Varreduras com vários
repositórios abrangem repositórios adicionais não listados aqui.
title: Repo Name
type: string
scan_id:
description: Identificador único da varredura.
title: Scan Id
type: string
scan_type:
description: Tipo de varredura, definido na criação.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
status:
description: >-
Status da varredura: waiting, pending, running, awaiting_user_input,
completed, failed ou cancelled.
enum:
- waiting
- pending
- running
- awaiting_user_input
- completed
- failed
- cancelled
title: Status
type: string
required:
- scan_id
- org_id
- repo_name
- host
- status
- profile
- scan_type
- created_at
title: CodeScanResponse
type: object
CodeScanProfileResponse:
description: Resumo do perfil sob o qual uma varredura foi executada.
properties:
name:
description: Nome do perfil.
title: Name
type: string
profile_id:
description: Identificador único do perfil.
title: Profile Id
type: string
required:
- profile_id
- name
title: CodeScanProfileResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuário de serviço (prefixo: cog_)'
scheme: bearer
type: http
````