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:approveau 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.
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.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.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
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.
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.
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.

