> ## 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.

# Déclencher Devin Review

> Déclenche une Devin Review pour une pull/merge request.

Crée un enregistrement dans la base de données qui sera pris en charge par le pool de workers de revue.
Récupère toujours le commit le plus récent de la PR.

<h2 id="permissions">
  Autorisations
</h2>

Nécessite 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) ayant l’autorisation `UseReviewManual` au niveau de l’entreprise.


## OpenAPI

````yaml fr/v3-openapi.yaml POST /v3/enterprise/pr-reviews
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/pr-reviews:
    post:
      tags:
        - pr-reviews
      summary: Déclencher Devin Review
      description: >-
        Déclenche une Devin Review pour une pull/merge request.


        Crée un enregistrement dans la base de données qui sera pris en charge
        par le pool de workers de revue.

        Récupère toujours le commit le plus récent de la PR.
      operationId: handle_create_pr_review_v3_enterprise_pr_reviews_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrReviewCreateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrReviewResponse'
          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: Non trouvé
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflit
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenu impossible à traiter
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Trop de requêtes
components:
  schemas:
    PrReviewCreateRequest:
      properties:
        pr_url:
          description: "URL complète de la pull/merge request à examiner (p.\_ex. `https://github.com/owner/repo/pull/123`)."
          examples:
            - https://github.com/owner/repo/pull/123
          title: Pr Url
          type: string
      required:
        - pr_url
      title: PrReviewCreateRequest
      type: object
    PrReviewResponse:
      properties:
        commit_sha:
          description: SHA du commit de tête de la PR qui sera examinée.
          title: Commit Sha
          type: string
        created_at:
          description: Date d’acceptation de la revue.
          format: date-time
          title: Created At
          type: string
        pr_number:
          description: Numéro de la pull/merge request.
          title: Pr Number
          type: integer
        repo_path:
          description: "Chemin de dépôt normalisé avec préfixe d’hôte (p.\_ex. `github.com/owner/repo`)."
          title: Repo Path
          type: string
        status:
          description: >-
            État actuel de la revue. Les revues nouvellement acceptées
            commencent avec l’état `pending`.
          enum:
            - pending
            - running
            - completed
            - errored
            - cancelled
            - skipped
          title: Status
          type: string
      required:
        - status
        - repo_path
        - pr_number
        - commit_sha
        - created_at
      title: PrReviewResponse
      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
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Code exploitable par machine indiquant le refus d’une action bloquée
            (p. ex. "user_frozen", "migrated_session").
          title: Error Code
        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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.