# 지원 액세스 권한 부여 목록

`GET /v1/support-access-grants` · 권한 `support-access-grants:read`

이 환경이 KeenAuth 지원 담당자에게 부여한 기간 제한 액세스를 최신순으로 나열합니다. 앞으로 페이지 매기기(`after`)만 지원되며 `before` 및 `desc` 이외의 `order`는 `422`를 반환합니다. `status`는 해당 상태의 권한 부여만 반환하며, `expired`는 취소되지 않았고 `expires_at`이 지난 권한 부여입니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `limit` | integer | 아니요 | 페이지 크기, 1-100(기본값 20). |
| `after` | string | 아니요 | 이전 페이지의 `list_metadata.after` 커서. |
| `status` | string | 아니요 | 이 상태의 권한 부여만: `active`, `revoked` 또는 `expired`. |

요청 본문이 없습니다.

## 응답

권한 부여 페이지와 함께 `200 OK`.

```json
{
  "data": [
    {
      "id": "sag_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "scope": "read",
      "status": "active",
      "ticket_ref": "SUP-48213",
      "allowed_regions_of_staff": ["eu"],
      "granted_by": "du_01j9xk2p5n7q9s1t3v5w7y9z1b",
      "created_at": "2026-10-12T09:30:00.123456Z",
      "expires_at": "2026-10-13T09:30:00.123456Z",
      "revoked_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## 오류

| HTTP | code | 조건 |
|---|---|---|
| 400 | `invalid_cursor` | 커서 형식이 잘못되었거나 다른 필터에 속합니다. |
| 422 | `validation_failed` | 쿼리 매개변수가 잘못되었습니다(`before`, `order=asc`, 알 수 없는 `status`). |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나 유효하지 않거나 취소되었습니다. |
| 429 | `rate_limited` | 속도 제한을 초과했습니다. `Retry-After` 시간 후에 다시 시도하세요. |
| 503 | `service_unavailable` | 종속 서비스를 일시적으로 사용할 수 없습니다. `Retry-After` 시간 후에 다시 시도하세요. |

## 예제

```bash
curl "https://api.eu.keenauth.com/v1/support-access-grants?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```