조직의 초대 목록 조회

GET /fapi/v1/organizations/{org_id}/invitations · 환경의 로그인 호스트에서 호출

조직 프로필 화면에 표시하기 위해 조직의 초대를 생성된 순서대로 나열합니다. 대기 중인 초대는 idp_members:read 권한을 함께 보유한 경우에만 초대된 주소가 표시되며, 그렇지 않으면 email은 null입니다. 수락, 취소 또는 만료된 초대에는 주소가 포함되지 않습니다.

인증된 사용자의 __Host-idp_session 쿠키 또는 자사 앱의 프런트 API 액세스 토큰(DPoP 증명과 함께 Authorization: DPoP <token>; 프런트 API 액세스 토큰 참조)이 필요합니다. 사용자는 조직의 활성 구성원이면서 idp_members:invite 권한을 보유해야 합니다. 구성원이 아닌 사용자는 404 not_found를, 권한이 없는 구성원은 403 insufficient_permissions를 받습니다.

@keenauth/js 사용 시: await keenauth.organizations.invitations(orgId, { status: "pending" }).

요청

헤더:

헤더 필수 설명
Idp-Client 예 SDK 식별자.

org_id: 조직 식별자(org_…).

쿼리 매개변수:

매개변수 필수 설명
status 아니요 pending, accepted, revoked 또는 expired; 생략하면 네 가지 모두.
after 아니요 이전 페이지의 next_after 값.
limit 아니요 1–100, 기본값 20.

본문 없음.

응답

{"data": [...], "next_after": "..."}와 함께 200 OK를 반환합니다. 마지막 페이지에서는 next_after가 없습니다. 각 항목은 초대의 필드를 가집니다.

오류

상태 코드 발생 조건
400 invalid_cursor after 형식이 잘못되었습니다.
401 unauthenticated 유효한 세션 쿠키 또는 토큰이 없습니다.
403 insufficient_permissions 사용자에게 조직의 idp_members:invite 권한이 없습니다.
404 not_found 해당 사용자에게 조직이 없습니다. 알 수 없거나, 형식이 잘못되었거나, 다른 사용자의 식별자도 같은 응답을 받습니다.
422 validation_failed status 또는 limit이 잘못되었습니다.
503 service_unavailable 일시적으로 사용할 수 없습니다. Retry-After 이후 다시 시도하십시오.

예제

curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations?status=pending&limit=1" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
      "email": "new.member@example.com",
      "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
      "delivery": "email",
      "delivery_status": "sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-11-03T10:00:00Z",
      "expires_at": "2026-11-10T10:00:00Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-11-03T10:00:00Z",
      "updated_at": "2026-11-03T10:00:00Z",
      "version": 1
    }
  ],
  "next_after": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d"
}

개인정보

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