> ## 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.
# Obtener perfil de análisis de código (API de Devin)
> Obtiene un perfil de análisis de código de Devin, incluidos su modo, tipo de análisis, patrones glob de inclusión/exclusión e instrucciones, mediante la API Enterprise 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 `ViewAccountCodeScans` en el nivel Enterprise.
## Comportamiento
Devuelve los metadatos del perfil, su visibilidad (propiedad de la organización o compartido en toda la cuenta), los patrones glob de inclusión/exclusión y todos los campos de instrucción (para investigación, comunicación y origen de ingesta).
Devuelve `404` si el perfil no existe o no es visible para la cuenta Enterprise. El equivalente en el ámbito de la organización es [Obtener perfil de análisis de código (organización)](/es/api-reference/v3/code-scans/organizations-code-scans-profile).
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/enterprise/code-scans/profiles/{profile_id}
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/{profile_id}:
get:
tags:
- code-scans
summary: Obtener perfil de análisis de código
description: >-
Obtener un perfil de análisis de código por ID.
Devuelve los metadatos del perfil, su visibilidad (propiedad de una
organización o compartido en la cuenta) y todos sus campos de guía.
Devuelve ``404`` cuando el perfil no existe o no es visible para la
cuenta Enterprise.
operationId: >-
handle_get_code_scan_profile_v3_enterprise_code_scans_profiles__profile_id__get
parameters:
- in: path
name: profile_id
required: true
schema:
title: Profile Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CodeScanProfileDetailResponse'
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:
CodeScanProfileDetailResponse:
description: >-
Detalles completos de un perfil de análisis de código, incluidas sus
instrucciones.
properties:
communication_guidance:
anyOf:
- type: string
- type: 'null'
description: >-
Directrices para la fase de comunicación (actuar sobre los hallazgos
finales, p. ej., notificar a responsables o partes interesadas), si
las hubiera.
title: Communication Guidance
created_at:
description: Cuándo se creó el perfil (segundos Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Descripción del perfil, si existe.
title: Description
exclude_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Patrones glob de archivos que se excluirán del análisis, si existen.
title: Exclude Globs
include_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Patrones glob de archivos que se incluirán en el análisis, si
existen.
title: Include Globs
ingestion_source_guidance:
anyOf:
- type: string
- type: 'null'
description: Instrucciones que describen el origen de la ingesta, si existen.
title: Ingestion Source Guidance
investigation_guidance:
anyOf:
- type: string
- type: 'null'
description: Instrucciones para la fase de investigación, si existen.
title: Investigation Guidance
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
post_ingestion_guidance:
anyOf:
- type: string
- type: 'null'
description: Instrucciones para la fase posterior a la ingesta, si existen.
title: Post Ingestion Guidance
profile_id:
description: Identificador único del perfil.
title: Profile Id
type: string
remediation_guidance:
anyOf:
- type: string
- type: 'null'
description: Instrucciones para la fase de remediación, si existen.
title: Remediation Guidance
report_guidance:
anyOf:
- type: string
- type: 'null'
description: Instrucciones para la fase de generación de informes, si existen.
title: Report Guidance
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
threat_model_guidance:
anyOf:
- type: string
- type: 'null'
description: Guía que describe el modelo de amenazas, si corresponde.
title: Threat Model Guidance
triage_guidance:
anyOf:
- type: string
- type: 'null'
description: Guía para la fase de triaje, si corresponde.
title: Triage Guidance
validation_guidance:
anyOf:
- type: string
- type: 'null'
description: Guía para la fase de validación, si corresponde.
title: Validation Guidance
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
- include_globs
- exclude_globs
- threat_model_guidance
- investigation_guidance
- triage_guidance
- validation_guidance
- report_guidance
- remediation_guidance
- ingestion_source_guidance
- post_ingestion_guidance
- created_at
title: CodeScanProfileDetailResponse
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
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````