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

# Examens d'agents indépendants

> Demandez un examen humain, recueillez des décisions distinctes et appliquez le résultat final dans votre application.

Les approbations d'agent enregistrent les décisions humaines concernant une action d'agent proposée dans un environnement d'espace de travail. Elles sont distinctes des approbations du moteur de workflow, des octrois d'autorisations, des reçus d'action cryptographiques et de l'exécution temporelle.

## Avant de commencer

* Utiliser un agent actif du même espace de travail et environnement que votre identifiant.
* Créez des requêtes en utilisant une clé API d'espace de travail ou un utilisateur d'espace de travail connecté.
* Les réviseurs doivent être des membres humains actifs de l'espace de travail avec la permission `tenant:governance:approve` au niveau de l'espace de travail. Un rôle réservé à l'organisation est insuffisant.
* Le demandeur ne peut pas approuver ou rejeter sa propre demande. Chaque réviseur peut décider une fois. Les clés API ne peuvent pas exprimer de votes humains.

Dans la Console, ouvrez **Agents IA → Approbations d'agents**. Les formulaires de demande, d'examen et d'annulation ont chacun une page dédiée. Enregistrez le lien de la demande pour y revenir après qu'elle ait quitté la file d'attente en attente.

## Créer une demande

Cet exemple demande deux approbations indépendantes dans une fenêtre d'une heure. Remplacez l'identifiant de l'agent par un agent sandbox existant ; un agent de production ne peut pas être utilisé avec une accréditation sandbox.

```bash theme={null}
curl --fail-with-body https://sandbox-api.truthlocks.com/v1/approvals \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "agent_id": "YOUR_SANDBOX_AGENT_ID",
    "action": "publish reviewed report",
    "resource": "reports/quarterly-review",
    "scope": "reports:publish",
    "risk_level": "high",
    "justification": "The report has completed technical review. Confirm the approved version before publication.",
    "required_approvals": 2,
    "ttl_minutes": 60
  }'
```

La réponse `201` contient `id`, `requested_by`, `status: "pending"`, `current_approvals: 0` et `expires_at`. Enregistrez `id` ; la création ne publie pas le rapport et ne crée pas de flux de travail en arrière-plan.

## Examiner avec une session humaine

Utilisez la Console pour les décisions interactives. Si votre intégration utilise l'API, fournissez la session de porteur de l'espace de travail de courte durée du réviseur. Ne substituez pas une clé API et n'intégrez pas de jeton de session dans le code source.

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID/approve" \
  -H "Authorization: Bearer $TRUTHLOCKS_REVIEWER_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Reviewed the exact report version and its supporting evidence."}'
```

La première approbation dans cet exemple renvoie `status: "pending"` et `current_approvals: 1`. Un autre réviseur autorisé doit fournir le second vote. La réutilisation du même réviseur renvoie un conflit. Un rejet modifie immédiatement la requête en `rejected` quelles que soient les approbations antérieures.

Le service vérifie les permissions d'adhésion actuelles, la propriété de la demande, l'expiration et les votes existants au sein de la transaction de décision. Les votes et l'événement d'audit sont validés ensemble. Les décisions ne peuvent pas être modifiées ou supprimées via ces API.

## Vérifier et appliquer le résultat

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID" \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY"
```

La réponse détaillée inclut l'historique du réviseur. Ne continuez que lorsque `status` est `approved` et que la requête correspond toujours exactement à l'agent, à l'action, à la ressource et à la portée que votre application a l'intention d'utiliser. Votre application doit également appliquer les autorisations d'accès actuelles, le statut de l'agent et ses propres contrôles d'utilisation unique ou de relecture. Ces enregistrements d'approbation ne fournissent pas de mécanisme d'exécution ou de consommation automatique.

| Statut | Signification |
| - | - |
| `pending` | Plus d'approbations indépendantes sont requises. |
| `approved` | Le quorum configuré a été atteint dans la fenêtre de révision. |
| `rejected` | Un examinateur indépendant a rejeté la demande. |
| `expired` | Une requête en attente a dépassé sa date limite de révision. |
| `cancelled` | Son demandeur initial l'a annulée. |

La date limite de révision limite le moment où les décisions peuvent être soumises. Elle ne transforme pas une demande déjà approuvée en un jeton d'accès expirant. Définissez toute date limite d'exécution dans votre propre application.

## File d'attente, annulation et erreurs

`GET /v1/approvals` renvoie un tableau d'au plus 100 requêtes en attente les plus anciennes et non expirées. Il n'a pas de pagination ni de filtre d'état historique. La file d'attente omet l'historique des décisions individuelles ; récupérez une requête par ID pour cet historique.

Le demandeur original peut envoyer `POST /v1/approvals/{approvalID}/cancel` avec un `reason` non vide. Une demande ne peut pas être rouverte après annulation, rejet, approbation ou expiration. Créez une nouvelle demande si l'action proposée change.

| Statut HTTP | Ce qu'il faut vérifier |
| - | - |
| `400` | Limites de champ, un ID de requête UUID et une raison de décision non vide. |
| `403` | Permission actuelle de réviseur de l'espace de travail, auto-révision du demandeur, vote par clé API ou propriété d'annulation. |
| `404` | La requête ou l'agent actif appartient à l'environnement de travail sélectionné. |
| `409` | La requête est finale, a expiré, ou cette personne a déjà voté. |

Ces enregistrements soutiennent votre processus d'examen ; ils n'établissent pas la conformité SOC 2, la certification ISO, la vérification de documents d'identité ou l'exactitude des preuves soumises.


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