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

# Trouver et valider des reviews

> Regardez la vidéo actuelle avant de valider sa review précise.

## Retrouver les reviews attendues

Accordez `reviews:read`, puis demandez :

```text theme={null}
Montre mes reviews VoiceStudio en attente. Pour chacune, indique le projet,
la vidéo, la langue et un lien direct pour la regarder. Ne valide rien.
```

Ouvrez le lien et regardez la vidéo. Le résultat contient `subjectRevision`, qui identifie la version examinée, et `approvable`, qui indique si la review est en attente et prend en charge la validation par API. Votre connexion doit aussi avoir la permission de validation et votre compte doit toujours disposer des droits de review.

## Valider une review précise

Il faut la permission facultative `reviews:approve` et un rôle d’administrateur ou de reviewer dans l’entreprise. Après avoir regardé la vidéo, indiquez exactement quelle review valider :

```text theme={null}
J’ai regardé la traduction française de Présentation du produit.
Consulte sa review VoiceStudio actuelle et valide cette version précise.
Si la review a changé, arrête-toi et demande-moi de la regarder à nouveau.
```

VoiceStudio vérifie la review en attente et sa version. Si une personne l’a modifiée ou a déjà décidé, la requête échoue avec un conflit. Consultez alors la review actuelle et prenez une nouvelle décision.

Les reviews de traduction et de lip-sync peuvent être validées par l’API et le MCP. Celles qui nécessitent un choix d’audition renvoient vers l’application VoiceStudio. Une validation ne crée pas un export et ne remplace pas la décision d’un autre reviewer.

## Valider depuis du code

Lisez d’abord `GET /reviews/{reviewId}`. Utilisez son `subjectRevision` actuel et générez un UUID pour la clé d’idempotence :

```bash theme={null}
curl --request POST \
  'https://api.tryvoicestudio.com/v1/reviews/01900000-0000-7000-8000-000000000002/approve' \
  -H "x-api-key: $VOICESTUDIO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 01900000-0000-7000-8000-000000000003' \
  --data '{"expectedSubjectRevision":5}'
```

Remplacez les valeurs d’exemple par celles de la review consultée et un nouvel UUID. Réutilisez cet UUID uniquement pour réessayer une décision identique après une réponse interrompue. Des paramètres différents avec le même UUID provoquent un conflit. L’auteur et la décision sont enregistrés dans l’historique des validations VoiceStudio.


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