Révoquer un accès au support

DELETE /v1/support-access-grants/{grant_id} · permission support-access-grants:write

Révoque une autorisation d'accès du support avant son expiration : revoked_at est renseigné, l'accès du personnel fondé sur elle prend fin et un événement support_access_grant.revoked est publié. L'enregistrement est conservé à des fins d'audit. Révoquer une autorisation déjà révoquée ou expirée ne change rien et renvoie quand même 204. Uniquement depuis le tableau de bord, par un owner ou un admin qui s'est de nouveau connecté au cours des 5 dernières minutes ; les clés API et les clients machine reçoivent 403 insufficient_permissions.

Requête

Champ Type Obligatoire Description
grant_id string oui Identifiant de l'autorisation (sag_…).

Pas de corps de requête.

Réponse

204 No Content.

Erreurs

HTTP code Quand
404 not_found L'autorisation n'existe pas ou appartient à un autre environnement.
403 insufficient_permissions La requête n'a pas été faite depuis le tableau de bord par un owner ou un admin, ou l'identifiant n'a pas la permission requise.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
429 rate_limited La limite de débit a été dépassée ; réessayez après le délai Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après le délai Retry-After.

Exemple

Création et révocation sont des actions du tableau de bord. Requête envoyée par le tableau de bord :

DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a