Réponse exemple
DELETE/v1/coffres/{id}/guestsRévoque un invité d'un coffre (statut passé à revoked).Révoque l'accès d'un invité à un coffre. La révocation est une suppression logique : le statut de l'invité passe à revoked plutôt que de supprimer la ligne, ce qui le retire des listes renvoyées par GET. L'opération vérifie au préalable que le coffre appartient au workspace de la clé. Note : ce handler ne lit pas de corps JSON au sens du wrapper (les requêtes DELETE n'ont pas leur corps parsé automatiquement), mais il attend néanmoins un champ guest_id.
Authentification
Requiert une clé API valide portant le scope coffres:manage. Un token avec coffres:* ou * satisfait également l'exigence via la table d'alias.
Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
| guest_id | string | Oui | Identifiant de l'invité à révoquer. L'invité doit être rattaché au coffre {id}. |
Réponse
En cas de succès, renvoie { "revoked": true }. La mise à jour cible l'invité par id et coffre_id ; si l'id ne correspond à aucun invité du coffre, l'opération réussit malgré tout (aucune ligne affectée) et renvoie revoked: true.
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| 400 validation_error | guest_id manquant ou non-string. | Fournir un guest_id valide. |
| 401 invalid_api_key | Clé absente, mal préfixée ou introuvable. | Vérifier l'en-tête Authorization. |
| 403 scope_missing | La clé ne porte pas coffres:manage. | Émettre une clé avec le bon scope. |
| 404 not_found | Le coffre n'existe pas dans le workspace. | Vérifier {id} et le workspace de la clé. |
| 429 rate_limited | Quota par minute dépassé. | Respecter Retry-After puis réessayer. |
| 500 internal_error | Échec de la mise à jour en base. | Réessayer ; contacter le support avec le request_id. |
Voir aussi
- GET /v1/coffres/{id}/guests — vérifier que l'invité n'apparaît plus
- POST /v1/coffres/{id}/guests — réinviter un invité révoqué
- PATCH /v1/coffres/{id}/guests — modifier un invité sans le révoquer