> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/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 organização e consulte o status da varredura usando filtros de tempo e repositório pela API de organizações v3
## Permissões
Requer um [usuário de serviço](/pt-BR/api-reference/v3/service-users/members-service-users) ou um [token de acesso pessoal](/pt-BR/api-reference/personal-access-tokens) com a permissão `ViewCodeScans` no nível da organização.
## Comportamento
Retorna as varreduras de código da organização, da mais recente para a mais antiga. Use este endpoint para consultar o `status` de uma varredura iniciada com [Iniciar varredura de código](/pt-BR/api-reference/v3/code-scans/organizations-code-scans-start): `waiting` → `pending` → `running` → `completed` (ou `failed` / `cancelled`). `awaiting_user_input` se aplica apenas a varreduras interativas iniciadas no app web; varreduras iniciadas pela API não entram nesse estado. Para listar varreduras em todas as organizações de uma Enterprise, use [Listar varreduras de código (Enterprise)](/pt-BR/api-reference/v3/code-scans/enterprise-code-scans-list).
### Filtros
* `time_after` / `time_before`: timestamps Unix em segundos (UTC) que delimitam o horário de criação da varredura.
* `repo_name`: apenas varreduras que analisaram este repositório. Inclui varreduras de vários repositórios que o contenham.
Os resultados são paginados com um cursor opaco (`after` / `first`).
## OpenAPI
````yaml pt-BR/v3-openapi.yaml GET /v3/organizations/{org_id}/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/organizations/{org_id}/code-scans/scans:
get:
tags:
- code-scans
summary: Listar varreduras de código
description: >-
Liste as varreduras de código da organização.
As varreduras são retornadas do mais recente para o mais antigo.
Opcionalmente, filtre por ``repo_name`` e horário de criação
(``time_after`` / ``time_before``); os resultados são paginados com um
cursor opaco (``after`` / ``first``).
operationId: handle_list_code_scans_v3_organizations__org_id__code_scans_scans_get
parameters:
- description: 'ID da organização (prefixo: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
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
- description: >-
Filtre para varreduras que analisaram este repositório. Inclui
varreduras de vários repositórios mesmo quando o repositório não é o
principal da varredura, portanto 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
varreduras de vários repositórios mesmo quando o repositório não é
o principal da varredura, portanto os itens retornados podem
informar um ``repo_name`` diferente.
title: Repo Name
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: Muitas requisições
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
````