
# Support-Zugriffsfreigabe widerrufen

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

Widerruft eine Support-Zugriffsfreigabe vor ihrem Ablauf: `revoked_at` wird gesetzt, der darauf beruhende Mitarbeiterzugriff endet und ein Ereignis `support_access_grant.revoked` wird veröffentlicht. Der Datensatz bleibt für das Audit erhalten. Das Widerrufen einer bereits widerrufenen oder abgelaufenen Freigabe ändert nichts und liefert trotzdem `204`. Nur im Dashboard, von einem `owner` oder `admin`, der sich in den letzten 5 Minuten erneut angemeldet hat; API-Schlüssel und Maschinenclients erhalten `403 insufficient_permissions`.

## Anfrage

| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| `grant_id` | string | ja | Freigabe-ID (`sag_…`). |

Kein Anfrage-Body.

## Antwort

`204 No Content`.

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Die Freigabe existiert nicht oder gehört zu einer anderen Umgebung. |
| 403 | `insufficient_permissions` | Die Anfrage wurde nicht aus dem Dashboard von einem `owner` oder `admin` gestellt, oder der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 401 | `unauthenticated` | Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; nach Ablauf der `Retry-After`-Zeit erneut versuchen. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach Ablauf der `Retry-After`-Zeit erneut versuchen. |

## Beispiel

Erstellen und Widerrufen sind Aktionen im Dashboard. Die Anfrage, die das Dashboard sendet:

```http
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a
```
