組織ロールを一覧取得

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

組織自身のロールと、組織管理者が割り当てられる環境ロールを識別子順に返します。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は 401 unauthenticated を返します。別オリジンのファーストパーティアプリは、代わりにフロント API アクセストークンを送信できます（Authorization: DPoP <token> と DPoP プルーフを付与します。詳細は フロント API アクセストークン を参照してください）。ユーザーは idp_roles:manage 権限を持つ組織のアクティブなメンバーである必要があります。メンバーでないユーザーには 404 not_found を返し、組織の存在は開示されません。権限のないメンバーには 403 insufficient_permissions を返します。組織ロールは環境で有効化され、そのプランに含まれている必要があります。

リクエスト

ヘッダー:

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

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

クエリパラメーター:

パラメーター 必須 説明
limit いいえ 1 ページあたりの件数。1 から 100 まで。デフォルトは 20。
after いいえ 前のページの next_after の値。

ボディなし。

レスポンス

200 OK:

フィールド 型 説明
data[] object[] ロールの配列。フィールドは 組織ロールを取得 で説明しています。
next_after string 次のページを取得する際に after として渡します。最後のページでは含まれません。 
{
  "data": [
    {
      "id": "rol_01jbz6x8kq3m2n4p5r6s7t8v9w",
      "organization_id": "org_01jbz6x8kq3m2n4p5r6s7t8v9a",
      "key": "auditor",
      "name": "Auditor",
      "description": "Read-only access to reports",
      "is_privileged": false,
      "assignable_in_self_service": true,
      "permission_ids": ["perm_01jbz6x8kq3m2n4p5r6s7t8v9b"],
      "created_at": "2026-10-28T09:30:00Z",
      "updated_at": "2026-10-28T09:30:00Z",
      "version": 1
    }
  ]
}

エラー

ステータス コード 発生条件
400 invalid_cursor after が前のページから得られたロールの識別子ではない。
401 unauthenticated 有効なセッション Cookie がない。
403 insufficient_permissions ユーザーが組織で idp_roles:manage を持っていない。
403 plan_feature_unavailable 環境のプランに組織ロールが含まれていない（feature、required_plan）。
403 org_custom_roles_disabled 環境で組織ロールが無効になっている。
404 not_found このユーザーに対して該当する組織またはロールがない（存在しない、形式が不正、または他のユーザーの識別子も同じ応答になります）。
422 validation_failed limit が範囲外。
503 service_unavailable 一時的に利用できない。Retry-After の後に再試行してください。

例

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