> ## 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 organización, incluidos los perfiles de descubrimiento e ingesta de la organización y los compartidos con la 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 `ViewCodeScans` a nivel de organización.
## Comportamiento
Devuelve resúmenes de perfiles (sin texto de orientación) ordenados del más reciente al más antiguo, incluidos los perfiles propiedad de la organización y los compartidos a nivel de 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 se puede pasar a [Iniciar análisis de código](/es/api-reference/v3/code-scans/organizations-code-scans-start) o [Iniciar análisis de ingestión](/es/api-reference/v3/code-scans/organizations-code-scans-start-ingestion).
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/organizations-code-scans-profile) para consultar la orientación completa de un perfil. El equivalente en el ámbito Enterprise es [Listar perfiles de análisis de código (Enterprise)](/es/api-reference/v3/code-scans/enterprise-code-scans-profiles).
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/organizations/{org_id}/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/organizations/{org_id}/code-scans/profiles:
get:
tags:
- code-scans
summary: Listar perfiles de análisis de código
description: >-
Lista los perfiles de análisis de código de la organización.
Devuelve primero los resúmenes de perfil más recientes (sin la guía),
incluidos tanto los perfiles propiedad de la organización como los
compartidos en la cuenta. Los resultados se paginan con un cursor opaco
(``after`` / ``first``).
operationId: >-
handle_list_code_scan_profiles_v3_organizations__org_id__code_scans_profiles_get
parameters:
- description: 'ID de la organización (prefijo: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
- 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
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/PaginatedResponse_CodeScanProfileSummaryResponse_
description: Respuesta correcta
'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
````