Revocare l'accesso al supporto
DELETE /v1/support-access-grants/{grant_id} · permesso support-access-grants:write
Revoca un'autorizzazione di accesso del supporto prima della sua scadenza: viene impostato revoked_at, l'accesso del personale basato su di essa termina e viene pubblicato un evento support_access_grant.revoked. Il record viene conservato per l'audit. Revocare un'autorizzazione già revocata o scaduta non cambia nulla e restituisce comunque 204. Solo dalla dashboard, da un owner o un admin che ha effettuato di nuovo l'accesso negli ultimi 5 minuti; le chiavi API e i client macchina ricevono 403 insufficient_permissions.
Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
grant_id |
string | sì | ID dell'autorizzazione (sag_…). |
Nessun corpo della richiesta.
Risposta
204 No Content.
Errori
| HTTP | code | Quando |
|---|---|---|
| 404 | not_found |
L'autorizzazione non esiste o appartiene a un altro ambiente. |
| 403 | insufficient_permissions |
La richiesta non è stata fatta dalla dashboard da un owner o un admin, oppure la credenziale non ha il permesso richiesto. |
| 401 | unauthenticated |
La credenziale manca, non è valida o è stata revocata. |
| 429 | rate_limited |
È stato superato il limite di frequenza; riprovare dopo il periodo indicato in Retry-After. |
| 503 | service_unavailable |
Una dipendenza non è temporaneamente disponibile; riprovare dopo il periodo indicato in Retry-After. |
Esempio
Creazione e revoca sono azioni della dashboard. La richiesta inviata dalla dashboard:
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a