> ## 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 perfiles de análisis de código (API de Devin)
> Lista los perfiles de análisis de código de Devin disponibles para una empresa, incluidos los perfiles de descubrimiento e ingesta propios de la organización y compartidos a nivel de cuenta
## Permisos
Requiere un [usuario de servicio](/es/api-reference/v3/service-users/members-service-users) o un [token de acceso personal](/es/api-reference/personal-access-tokens) con el permiso `ViewAccountCodeScans` en el nivel Enterprise.
## Comportamiento
Devuelve resúmenes de perfiles (sin el texto de orientación), ordenados del más reciente al más antiguo, incluidos los perfiles propiedad de la organización y los compartidos en toda la cuenta (`org_id` es `null` para los perfiles compartidos). Cada resumen incluye el `mode` del perfil (`discover` o `ingest`) y el `scan_type`, que determinan si puede usarse con [Iniciar análisis de código](/es/api-reference/v3/code-scans/enterprise-code-scans-start) o [Iniciar análisis de ingesta](/es/api-reference/v3/code-scans/enterprise-code-scans-start-ingestion).
Opcionalmente, filtre por `org_ids`; los resultados se paginan mediante un cursor opaco (`after` / `first`). Use [Obtener perfil de análisis de código](/es/api-reference/v3/code-scans/enterprise-code-scans-profile) para consultar la orientación completa de un perfil. El equivalente con ámbito de organización es [Listar perfiles de análisis de código (organización)](/es/api-reference/v3/code-scans/organizations-code-scans-profiles).
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/enterprise/code-scans/profiles
openapi: 3.1.0
info:
description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/enterprise/code-scans/profiles:
get:
tags:
- code-scans
summary: Listar perfiles de análisis de código
description: >-
Listar perfiles de análisis de código de la cuenta Enterprise.
Devuelve resúmenes de perfiles (sin guía), del más reciente al más
antiguo, incluidos tanto los perfiles propiedad de organizaciones como
los perfiles compartidos en la cuenta. Opcionalmente, filtre por
``org_ids``; los resultados se paginan con un 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: >-
Devuelva solo los perfiles visibles para estas organizaciones. De
forma predeterminada, se devuelven todas las organizaciones de la
cuenta.
in: query
name: org_ids
required: false
schema:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Devuelva solo los perfiles visibles para estas organizaciones. De
forma predeterminada, se devuelven todas las organizaciones de la
cuenta.
title: Org Ids
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/PaginatedResponse_CodeScanProfileSummaryResponse_
description: Respuesta satisfactoria
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Prohibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflicto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenido no procesable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Demasiadas solicitudes
components:
schemas:
PaginatedResponse_CodeScanProfileSummaryResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor para obtener la página siguiente, o None si esta es la última
página.
title: End Cursor
has_next_page:
default: false
description: Indica si hay más elementos disponibles después de 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: Recuento total opcional (puede omitirse por motivos de rendimiento).
title: Total
required:
- items
title: PaginatedResponse[CodeScanProfileSummaryResponse]
type: object
ProblemDetail:
description: >-
Cuerpo de error RFC 9457 application/problem+json para la API v3.
detail se conserva del cuerpo heredado {"detail": ...} por
compatibilidad con versiones anteriores; los
otros miembros son adicionales. errors contiene errores de validación
a nivel de campo (solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explicación legible para humanos específica de esta ocurrencia.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errores de validación por campo (solo en respuestas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
title: Instance
status:
description: El código de estado HTTP.
title: Status
type: integer
title:
description: Un breve resumen del tipo de problema, legible para humanos.
title: Title
type: string
type:
default: about:blank
description: Una referencia URI que identifica el tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
CodeScanProfileSummaryResponse:
description: Resumen de un perfil de análisis de código, sin su guía.
properties:
created_at:
description: Momento en que se creó el perfil (segundos Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Descripción del perfil, si corresponde.
title: Description
mode:
description: 'Modo del perfil: discover o ingest.'
enum:
- discover
- ingest
title: Mode
type: string
name:
description: Nombre del perfil.
title: Name
type: string
org_id:
anyOf:
- type: string
- type: 'null'
description: >-
Organización propietaria del perfil. Null cuando el perfil se
comparte en toda la cuenta.
title: Org Id
profile_id:
description: Identificador único del perfil.
title: Profile Id
type: string
scan_type:
description: Tipo de análisis que configura el perfil.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
visibility:
description: >-
Indica si el perfil pertenece a una sola organización o si se
comparte en toda la cuenta.
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 usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````