> ## 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.
# Obtenir un profil d’analyse de code (API Devin)
> Récupérer un profil d’analyse de code Devin, avec son mode, son type d’analyse, ses motifs glob d’inclusion et d’exclusion, ainsi que ses instructions, via l’API Enterprise v3
## Autorisations
Requiert un [utilisateur de service](/fr/api-reference/v3/service-users/members-service-users) ou un [jeton d’accès personnel](/fr/api-reference/personal-access-tokens) doté de l’autorisation `ViewAccountCodeScans` au niveau Enterprise.
## Comportement
Renvoie les métadonnées du profil, sa visibilité (propre à l’organisation ou partagée à l’échelle du compte), les motifs glob d’inclusion/exclusion et tous ses champs d’instructions (pour l’investigation, la communication et la source d’ingestion).
Renvoie `404` si le profil n’existe pas ou n’est pas visible par le compte Enterprise. L’équivalent dans le périmètre de l’organisation est [Obtenir le profil d’analyse de code (organisation)](/fr/api-reference/v3/code-scans/organizations-code-scans-profile).
## OpenAPI
````yaml fr/v3-openapi.yaml GET /v3/enterprise/code-scans/profiles/{profile_id}
openapi: 3.1.0
info:
description: API Devin v3 avec authentification par compte de service et 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: Récupérer le profil d’analyse de code
description: >-
Récupérer un profil d’analyse de code par ID.
Renvoie les métadonnées du profil, sa visibilité (appartenant à une
organisation ou partagé à l’échelle du compte) et tous ses champs de
consignes. Renvoie ``404`` si le profil n’existe pas ou n’est pas
visible pour le compte 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: Réponse réussie
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorisé
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Interdit
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Introuvable
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflit
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenu non traitable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Trop de requêtes
components:
schemas:
CodeScanProfileDetailResponse:
description: >-
Détails complets d’un profil d’analyse de code, y compris ses
instructions.
properties:
communication_guidance:
anyOf:
- type: string
- type: 'null'
description: >-
Instructions pour la phase de communication (traitement des constats
finaux, par ex. notification des responsables ou des parties
prenantes), le cas échéant.
title: Communication Guidance
created_at:
description: Horodatage de création du profil (secondes Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Description du profil, le cas échéant.
title: Description
exclude_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Motifs glob des fichiers à exclure de l’analyse, le cas échéant.
title: Exclude Globs
include_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Motifs glob des fichiers à inclure dans l’analyse, le cas échéant.
title: Include Globs
ingestion_source_guidance:
anyOf:
- type: string
- type: 'null'
description: Instructions décrivant la source d’ingestion, le cas échéant.
title: Ingestion Source Guidance
investigation_guidance:
anyOf:
- type: string
- type: 'null'
description: Instructions pour la phase d’investigation, le cas échéant.
title: Investigation Guidance
mode:
description: "Mode du profil\_: discover ou ingest."
enum:
- discover
- ingest
title: Mode
type: string
name:
description: Nom du profil.
title: Name
type: string
org_id:
anyOf:
- type: string
- type: 'null'
description: >-
Organisation propriétaire du profil. Null si le profil est partagé à
l’échelle du compte.
title: Org Id
post_ingestion_guidance:
anyOf:
- type: string
- type: 'null'
description: Instructions pour la phase post-ingestion, le cas échéant.
title: Post Ingestion Guidance
profile_id:
description: Identifiant unique du profil.
title: Profile Id
type: string
remediation_guidance:
anyOf:
- type: string
- type: 'null'
description: Instructions pour la phase de remédiation, le cas échéant.
title: Remediation Guidance
report_guidance:
anyOf:
- type: string
- type: 'null'
description: Instructions pour la phase de génération du rapport, le cas échéant.
title: Report Guidance
scan_type:
description: Type d’analyse configuré par le profil.
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: Consignes décrivant le modèle de menace, le cas échéant.
title: Threat Model Guidance
triage_guidance:
anyOf:
- type: string
- type: 'null'
description: Consignes pour la phase de triage, le cas échéant.
title: Triage Guidance
validation_guidance:
anyOf:
- type: string
- type: 'null'
description: Consignes pour la phase de validation, le cas échéant.
title: Validation Guidance
visibility:
description: >-
Indique si le profil appartient à une seule organisation ou s’il est
partagé à l’échelle du compte.
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: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explication en langage clair, spécifique à cette occurrence.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erreurs de validation par champ (réponses 422 uniquement).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
title: Instance
status:
description: Le code d’état HTTP.
title: Status
type: integer
title:
description: Un bref résumé du type de problème, compréhensible par un humain.
title: Title
type: string
type:
default: about:blank
description: Une référence d’URI identifiant le type de problème.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
securitySchemes:
bearerAuth:
description: "Identifiant de compte de service (préfixe\_: cog_)"
scheme: bearer
type: http
````