> ## 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 perfis de varredura de código (API do Devin)
> Lista os perfis de varredura de código do Devin disponíveis para uma Enterprise, incluindo perfis de descoberta e ingestão pertencentes à organização e compartilhados pela conta
## 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 resumos de perfis (sem o texto de orientação), do mais recente ao mais antigo, incluindo perfis pertencentes à organização e perfis compartilhados em nível da conta (`org_id` é `null` para perfis compartilhados). Cada resumo inclui o `mode` do perfil (`discover` ou `ingest`) e o `scan_type`, que determinam se ele pode ser usado em [Iniciar Varredura de Código](/pt-BR/api-reference/v3/code-scans/enterprise-code-scans-start) ou [Iniciar Varredura de Ingestão](/pt-BR/api-reference/v3/code-scans/enterprise-code-scans-start-ingestion).
Opcionalmente, filtre por `org_ids`; os resultados são paginados com um cursor opaco (`after` / `first`). Use [Obter Perfil de Varredura de Código](/pt-BR/api-reference/v3/code-scans/enterprise-code-scans-profile) para ler todas as orientações de um perfil. O equivalente no escopo da organização é [Listar Perfis de Varredura de Código (Organização)](/pt-BR/api-reference/v3/code-scans/organizations-code-scans-profiles).
## OpenAPI
````yaml pt-BR/v3-openapi.yaml GET /v3/enterprise/code-scans/profiles
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/profiles:
get:
tags:
- code-scans
summary: Listar perfis de varredura de código
description: >-
Liste os perfis de varredura de código da conta Enterprise.
Retorna resumos dos perfis (sem orientações), do mais recente para o
mais antigo, incluindo perfis pertencentes à organização e
compartilhados no nível da conta. Opcionalmente, filtre por ``org_ids``;
os resultados são paginados com um cursor opaco (``after`` / ``first``).
operationId: handle_list_code_scan_profiles_v3_enterprise_code_scans_profiles_get
parameters:
- 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: >-
Retorna apenas os perfis visíveis para estas organizações. O padrão
é considerar todas as organizações da conta.
in: query
name: org_ids
required: false
schema:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Retorna apenas os perfis visíveis para estas organizações. O
padrão é considerar todas as organizações da conta.
title: Org Ids
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/PaginatedResponse_CodeScanProfileSummaryResponse_
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_CodeScanProfileSummaryResponse_:
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/CodeScanProfileSummaryResponse'
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[CodeScanProfileSummaryResponse]
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
CodeScanProfileSummaryResponse:
description: Resumo de um perfil de varredura de código, sem suas orientações.
properties:
created_at:
description: Quando o perfil foi criado (segundos Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Descrição do perfil, se houver.
title: Description
mode:
description: 'Modo do perfil: discover ou ingest.'
enum:
- discover
- ingest
title: Mode
type: string
name:
description: Nome do perfil.
title: Name
type: string
org_id:
anyOf:
- type: string
- type: 'null'
description: >-
Organização proprietária do perfil. Null quando o perfil é
compartilhado em nível da conta.
title: Org Id
profile_id:
description: Identificador único do perfil.
title: Profile Id
type: string
scan_type:
description: Tipo de varredura que o perfil configura.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
visibility:
description: >-
Indica se o perfil pertence a uma única organização ou se é
compartilhado em toda a conta.
enum:
- org
- account
title: Visibility
type: string
required:
- profile_id
- name
- description
- visibility
- org_id
- scan_type
- mode
- created_at
title: CodeScanProfileSummaryResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuário de serviço (prefixo: cog_)'
scheme: bearer
type: http
````