Revocar el acceso al soporte
DELETE /v1/support-access-grants/{grant_id} · permiso support-access-grants:write
Revoca una autorización de acceso del soporte antes de que venza: se establece revoked_at, termina el acceso del personal que se basaba en ella y se publica un evento support_access_grant.revoked. El registro se conserva para la auditoría. Revocar una autorización que ya está revocada o vencida no cambia nada y sigue devolviendo 204. Solo desde el panel, por un owner o admin que haya vuelto a iniciar sesión en los últimos 5 minutos; las claves de API y los clientes de máquina reciben 403 insufficient_permissions.
Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
grant_id |
string | sí | ID de la autorización (sag_…). |
Sin cuerpo de solicitud.
Respuesta
204 No Content.
Errores
| HTTP | código | Cuándo |
|---|---|---|
| 404 | not_found |
La autorización no existe o pertenece a otro entorno. |
| 403 | insufficient_permissions |
La solicitud no se hizo desde el panel por un owner o admin, o la credencial no tiene el permiso requerido. |
| 401 | unauthenticated |
La credencial falta, no es válida o fue revocada. |
| 429 | rate_limited |
Se superó el límite de frecuencia; vuelva a intentarlo tras el tiempo indicado en Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; vuelva a intentarlo tras el tiempo indicado en Retry-After. |
Ejemplo
Crear y revocar son acciones del panel. La solicitud que envía el panel:
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a