サポートアクセス許可を取り消す
DELETE /v1/support-access-grants/{grant_id} · 権限 support-access-grants:write
期限切れになる前にサポートアクセス許可を取り消します。revoked_at が設定され、この許可に基づく担当者のアクセスは終了し、support_access_grant.revoked イベントが発行されます。レコードは監査のために保持されます。すでに取り消されているか期限切れの許可を取り消しても何も変わらず、それでも 204 を返します。直近 5 分以内に再認証した owner または admin が、ダッシュボードからのみ実行できます。API キーとマシンクライアントは 403 insufficient_permissions を受け取ります。
リクエスト
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
grant_id |
string | はい | 許可 ID (sag_…)。 |
リクエストボディはありません。
レスポンス
204 No Content。
エラー
| HTTP | コード | 概要 |
|---|---|---|
| 404 | not_found |
許可が存在しないか、別の環境に属しています。 |
| 403 | insufficient_permissions |
リクエストがダッシュボードから owner または admin によって行われていないか、認証情報に必要な権限がありません。 |
| 401 | unauthenticated |
認証情報がないか、無効または失効しています。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の時間が過ぎてから再試行してください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。Retry-After の時間が過ぎてから再試行してください。 |
例
作成と取り消しはダッシュボードの操作です。ダッシュボードが送信するリクエスト:
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a