組織のメンバーを一覧表示

GET /fapi/v1/organizations/{org_id}/memberships · 環境のサインインホストから呼び出します

組織のメンバーシップを最終変更日順に一覧表示します。組織のプロフィール画面で使用します。保留中の招待は表示されません。各行のユーザーは usr_… 識別子のみで示され、このエンドポイントはユーザー名やメールアドレスを返しません。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie が存在しない、期限切れである、または取り消されている場合は 401 unauthenticated を返します。別のオリジンにある自社アプリは、代わりにフロント API のアクセストークンを送信できます（Authorization: DPoP <token> と DPoP 証明書を使用します。フロント API アクセストークンを参照してください）。ユーザーは組織のアクティブなメンバーであり、idp_members:read 権限を持っている必要があります。メンバーではないユーザーには 404 not_found を返します。権限を持たないメンバーには 403 insufficient_permissions を返します。

@keenauth/js を使用する場合: await keenauth.organizations.members(orgId, { status: "active" })。

リクエスト

ヘッダー:

ヘッダー	必須	説明
`Idp-Client`	はい	SDK の識別子です。

org_id: 組織の識別子（org_…）です。

クエリパラメーター:

パラメーター	必須	説明
`status`	いいえ	`active`、`suspended`、`removed`。省略した場合は三つすべてが対象になります。
`role_id`	いいえ	このロールを持つメンバーシップのみを対象にします（`rol_…`）。
`after`	いいえ	前のページの `next_after` の値です（不透明な値）。
`limit`	いいえ	1〜100。既定値は 20 です。

ボディはありません。

レスポンス

200 OK で {"data": [...], "next_after": "..."} を返します。next_after は最後のページでは含まれません。

各項目: id（mem_…）、user_id（usr_…）、status、roles（各 role_id と、ロールの割り当て元である source を含みます。値は admin_api や default などです）、created_at、activated_at（または null）、expires_at（または null）、updated_at、version。

エラー

ステータス	コード	発生条件
400	`invalid_cursor`	`after` の形式が正しくありません。
401	`unauthenticated`	有効なセッション Cookie がありません。
403	`insufficient_permissions`	ユーザーに組織内の `idp_members:read` がありません。
404	`not_found`	このユーザーに対して該当する組織がありません。存在しない識別子、形式が正しくない識別子、他のユーザーの識別子に対しては、同じ応答を返します。
422	`validation_failed`	`status`、`role_id`、`limit` のいずれかが無効です。
503	`service_unavailable`	一時的に利用できません。`Retry-After` の後に再試行してください。

例

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

{
  "data": [
    {
      "id": "mem_01jbz6x8kq3m2n4p5r6s7t8v9b",
      "user_id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9c",
      "status": "active",
      "roles": [{ "role_id": "rol_01jbz6x8kq3m2n4p5r6s7t8v9w", "source": "admin_api" }],
      "created_at": "2026-11-03T09:00:00Z",
      "activated_at": "2026-11-03T09:00:00Z",
      "expires_at": null,
      "updated_at": "2026-11-03T09:00:00Z",
      "version": 1
    }
  ],
  "next_after": "AAAYQ3dAgGUBmgAAAABwAIAAAAAAAADh"
}

個人データ

このエンドポイントは個人データを扱います。組織のメンバーシップと招待が対象です。KeenAuth API における個人データでは、保存される内容、保管期間、削除方法を説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。