> ## 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 análisis de código (API de Devin)
> Lista los análisis de código de Devin de una organización y consulta su estado, con filtros por fecha y repositorio, mediante la API de organizaciones v3
## 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 los análisis de código de la organización, ordenados del más reciente al más antiguo. Úsalo para consultar el `status` de un análisis iniciado con [Iniciar análisis de código](/es/api-reference/v3/code-scans/organizations-code-scans-start): `waiting` → `pending` → `running` → `completed` (o `failed` / `cancelled`). `awaiting_user_input` solo se aplica a análisis interactivos iniciados desde la aplicación web; los análisis iniciados mediante la API no entran en este estado. Para listar análisis de todas las organizaciones de una empresa, usa [Listar análisis de código (Enterprise)](/es/api-reference/v3/code-scans/enterprise-code-scans-list).
### Filtros
* `time_after` / `time_before`: marcas de tiempo Unix en segundos (UTC) que delimitan el momento de creación del análisis.
* `repo_name`: solo análisis que analizaron este repositorio. También coincide con análisis de varios repositorios que lo incluyen.
Los resultados se paginan con un cursor opaco (`after` / `first`).
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/scans
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/scans:
get:
tags:
- code-scans
summary: Listar análisis de código
description: >-
Lista los análisis de código de la organización.
Los análisis se devuelven primero los más recientes. De forma opcional,
filtra por ``repo_name`` y por hora de creación (``time_after`` /
``time_before``); los resultados se paginan con un cursor opaco
(``after`` / ``first``).
operationId: handle_list_code_scans_v3_organizations__org_id__code_scans_scans_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: 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: >-
Filtra los análisis que incluyeron este repositorio. También
coincide con análisis de varios repositorios, incluso cuando este no
es el repositorio principal del análisis, por lo que los elementos
devueltos pueden indicar un ``repo_name`` diferente.
in: query
name: repo_name
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
Filtra los análisis que incluyeron este repositorio. También
coincide con análisis de varios repositorios, incluso cuando este
no es el repositorio principal del análisis, por lo que los
elementos devueltos pueden indicar un ``repo_name`` diferente.
title: Repo Name
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_CodeScanResponse_'
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_CodeScanResponse_:
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/CodeScanResponse'
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[CodeScanResponse]
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
CodeScanResponse:
description: Un análisis de código individual.
properties:
created_at:
description: Momento en que se creó el análisis (segundos Unix).
title: Created At
type: integer
host:
anyOf:
- type: string
- type: 'null'
description: Host de Git del repositorio, si se conoce.
title: Host
org_id:
description: Organización a la que pertenece el análisis.
title: Org Id
type: string
profile:
anyOf:
- $ref: '#/components/schemas/CodeScanProfileResponse'
- type: 'null'
description: Perfil con el que se ejecutó el análisis, si corresponde.
repo_name:
description: >-
Repositorio principal del análisis. Los análisis de varios
repositorios abarcan repositorios adicionales que no se enumeran
aquí.
title: Repo Name
type: string
scan_id:
description: Identificador único del análisis.
title: Scan Id
type: string
scan_type:
description: Tipo de análisis, establecido al crearlo.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
status:
description: >-
Estado del análisis: waiting, pending, running, awaiting_user_input,
completed, failed o 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: Resumen del perfil con el que se ejecutó un análisis.
properties:
name:
description: Nombre del perfil.
title: Name
type: string
profile_id:
description: Identificador único del perfil.
title: Profile Id
type: string
required:
- profile_id
- name
title: CodeScanProfileResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````