초대 목록 조회

GET /v1/invitations · 권한 invitations:read

이 환경의 초대 목록을 오래된 순서로 반환합니다. 다음 방향 페이지네이션만 지원합니다. 필터는 organization_id, email(정확히 일치), status를 지원합니다. 커서는 필터에 연결되며, 이메일은 키가 적용된 해시 형태로만 커서에 포함됩니다. 수락 링크는 목록에 포함되지 않습니다.

요청

필드 타입 필수 설명
limit query 아니요 1–100. 기본값은 20입니다.
after query 아니요 list_metadata.after의 커서.
organization_id query 아니요 조직 ID(org_…).
email query 아니요 이메일 주소(정확히 일치).
status query 아니요 pending, accepted, revoked 또는 expired.

요청 본문은 없습니다.

응답

초대 페이지가 포함된 200 OK를 반환합니다.

{
  "data": [
    {
      "id": "inv_01j9xt9v3w4y8z0a2b4c6d8e0g",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "email": "ada@example.com",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ],
      "application_id": null,
      "delivery": "link_only",
      "delivery_status": "not_sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-10-12T09:31:00.123456Z",
      "expires_at": "2026-10-19T09:31:00.123456Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

오류

HTTP code 발생 조건
400 invalid_cursor 커서가 유효하지 않거나 다른 필터에 속합니다.
422 validation_failed 필터 또는 limit이 유효하지 않거나, before 또는 asc가 아닌 order가 지정되었습니다.
401 unauthenticated 자격 증명이 없거나 유효하지 않거나 폐기되었습니다.
403 insufficient_permissions 자격 증명에 필요한 권한이 없습니다.
429 rate_limited 요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오.
503 service_unavailable 종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오.

예시

curl -i "https://api.eu.keenauth.com/v1/invitations?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=pending" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

개인 데이터

이 엔드포인트는 조직 구성원 자격과 초대 등 개인 데이터를 다룹니다. KeenAuth API의 개인 데이터에서 저장되는 항목, 보관 기간, 삭제 방법을 확인하실 수 있습니다. 어떤 필드에도 특수 범주의 개인 데이터(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.