# 일괄 사용자 삭제 결과 목록

`GET /v1/jobs/user-deletions/{job_id}/results` · 권한 `users:delete`

일괄 사용자 삭제 작업에서 각 사용자의 결과를 요청 순서대로 나열합니다(`position`은 1부터 시작합니다). 각 결과는 다음 중 하나입니다.

- `pending`: 사용자에게 아직 결과가 없습니다.
- `succeeded`: 사용자의 삭제가 시작되었습니다. `deletion_id`는 해당 사용자에 대해 [`DELETE /v1/users/{user_id}`](/docs/api/management/users/delete)가 반환하는 것과 같은 ID입니다.
- `not_found`: 사용자가 이 환경에 없거나 이미 삭제되었습니다.
- `failed`: 여러 번 시도한 뒤 삭제에 실패했습니다. `error_code`는 `internal`입니다. 해당 사용자를 개별적으로 또는 새 작업에서 다시 삭제하십시오.

결과에는 사용자 ID만 포함되며, 다른 개인정보는 반환되지 않습니다. 목록은 앞으로만 넘길 수 있습니다. 다음 페이지는 `list_metadata.after`를 사용하십시오. `before`와 `order`는 지원되지 않습니다.

## 요청

| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
| `job_id` | path | 예 | 작업 ID, `job_` 접두사가 붙습니다. |
| `limit` | query | 아니요 | 페이지 크기, 1에서 100. 기본값 20. |
| `after` | query | 아니요 | `list_metadata.after`에서 얻은 불투명 커서. 같은 작업에서만 유효합니다. |

## 응답

`200 OK`. `list_metadata.after`는 다음 페이지의 커서입니다(마지막 페이지에서는 `null`). `list_metadata.before`는 항상 `null`입니다.

```json
{
  "data": [
    {
      "position": 1,
      "user_id": "usr_01h455vb4pex5vsknk084sn02q",
      "status": "succeeded",
      "deletion_id": "0191f0a0-0000-8000-8000-000000000001"
    },
    {
      "position": 2,
      "user_id": "usr_01h455vb4pex5vsknk084sn02r",
      "status": "not_found"
    }
  ],
  "list_metadata": { "before": null, "after": null }
}
```

## 오류

모든 오류는 안정적인 `code`를 담은 `application/problem+json` 본문입니다.

| HTTP | `code` | 언제 |
|---|---|---|
| 400 | `invalid_cursor` | 커서가 잘못되었거나 만료되었거나 다른 작업에 속합니다. |
| 401 | `unauthenticated` | API 키가 없거나 잘못되었거나 폐기되었습니다. |
| 403 | `insufficient_permissions` | 키에 `users:delete` 권한이 없습니다. |
| 404 | `not_found` | 이 환경에 작업이 없습니다(또는 ID 형식이 잘못되었습니다). |
| 422 | `validation_failed` | `limit`이 범위를 벗어났거나, `before` 또는 `order`가 전송되었습니다(`not_supported`). |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After`를 따르십시오. |
| 503 | `service_unavailable` | 의존 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |

## 예제

```bash
curl "https://api.eu.keenauth.com/v1/jobs/user-deletions/job_01h455vb4pex5vsknk084sn02q/results?limit=100" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth jobs user-deletions results job_01h455vb4pex5vsknk084sn02q --limit 100`