> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Demander l'approbation de l'agent

> Enregistre une demande d'examen humain indépendant. N'exécute pas d'action d'agent, n'accorde pas de permissions et ne met pas automatiquement en pause ou ne reprend pas un workflow Temporal.

Enregistre une demande d'examen humain indépendant. N'exécute pas d'action d'agent, n'accorde pas de permissions et ne met pas automatiquement en pause ou ne reprend pas un workflow Temporal.

Voir [revues d'agents indépendants](https://docs.truthlocks.com/fr/guides/agent-approvals.md) pour les limites d'autorisation et d'exécution.


## OpenAPI

````yaml fr/maip-openapi.yaml POST /v1/approvals
openapi: 3.0.3
info:
  title: Truthlocks MAIP receipts and approvals
  version: 2.0.0
servers:
  - url: https://api.truthlocks.com
    description: Production
  - url: https://sandbox-api.truthlocks.com
    description: Bac à sable
security:
  - apiKey: []
  - bearerAuth: []
paths:
  /v1/approvals:
    post:
      tags:
        - Agent approvals
      summary: Demander l'approbation de l'agent
      description: >-
        Enregistre une demande d'examen humain indépendant. N'exécute pas
        d'action d'agent, n'accorde pas de permissions et ne met pas
        automatiquement en pause ou ne reprend pas un workflow Temporal.
      operationId: maipApprovalsCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - agent_id
                - action
                - resource
                - scope
              properties:
                agent_id:
                  type: string
                  description: >-
                    Un agent actif et non compromis dans cet environnement
                    d'espace de travail authentifié.
                action:
                  type: string
                  description: >-
                    L'action prévue ; 1 à 200 octets UTF-8. La création d'une
                    requête ne l'exécute pas.
                resource:
                  type: string
                  description: Ressource cible spécifique ; 1 à 2000 octets UTF-8.
                scope:
                  type: string
                  description: >-
                    Permission prévue ; 1 à 200 octets UTF-8. N'accorde pas
                    l'accès.
                justification:
                  type: string
                  description: >-
                    Preuves et objectif ; au maximum 4000 octets UTF-8.
                    N'incluez jamais de secrets.
                risk_level:
                  type: string
                  enum:
                    - low
                    - medium
                    - high
                    - critical
                  default: medium
                required_approvals:
                  type: integer
                  minimum: 1
                  maximum: 10
                  default: 1
                  description: Examinateurs humains autorisés distincts ; demandeur exclu.
                ttl_minutes:
                  type: integer
                  minimum: 1
                  maximum: 10080
                  default: 60
      responses:
        '201':
          description: Résultat enregistré
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentApproval'
        '400':
          description: Identifiant, champs de requête ou motif de décision invalides
        '401':
          description: Authentification requise
        '403':
          description: >-
            Mauvais domaine d'espace de travail, permission de réviseur actuel
            manquante, auto-révision ou annulation non autorisée
        '404':
          description: >-
            Agent demandeur ou actif absent de cet environnement d'espace de
            travail
        '409':
          description: Déjà décidé, examinateur en double ou demande expirée
components:
  schemas:
    AgentApproval:
      type: object
      required:
        - id
        - agent_id
        - status
        - requested_by
        - required_approvals
        - current_approvals
        - expires_at
        - decisions
      properties:
        id:
          type: string
          format: uuid
        tenant_id:
          type: string
          format: uuid
        agent_id:
          type: string
        action:
          type: string
        resource:
          type: string
        scope:
          type: string
        justification:
          type: string
        requested_by:
          type: string
          description: >-
            Demandeur authentifié : UUID d'utilisateur humain ou api_key:<stored
            key ID> ; jamais un réviseur fourni par l'appelant.
        decision_reason:
          type: string
        status:
          type: string
          enum:
            - pending
            - approved
            - rejected
            - expired
            - cancelled
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
        decided_at:
          type: string
          format: date-time
        decided_by:
          type: string
          description: >-
            Annulation de la demande par le réviseur final ou le demandeur ;
            absent en attente.
        required_approvals:
          type: integer
          minimum: 1
          maximum: 10
        current_approvals:
          type: integer
          minimum: 0
          maximum: 10
        decisions:
          type: array
          description: >-
            Examens individuels immuables. La réponse de la file d'attente
            laisse ce champ vide ; obtenez la demande pour son historique
            d'examen complet.
          items:
            type: object
            properties:
              reviewer_id:
                type: string
                format: uuid
              decision:
                type: string
                enum:
                  - approved
                  - rejected
              reason:
                type: string
              created_at:
                type: string
                format: date-time
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
    bearerAuth:
      type: http
      scheme: bearer

````

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