組織を取得
GET /fapi/v1/organizations/{org_id} · 環境のサインインホストから呼び出し
組織の管理者が見るとおりの、組織のプロフィール（名前、スラッグ、ステータス、ブランドカラー、バージョン）を返します。組織プロフィールの画面で表示される内容です。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は 401 unauthenticated を返します。別オリジンの自社アプリは、代わりにフロントAPIアクセストークン（DPoP 証明付きの Authorization: DPoP <token>。フロントAPIアクセストークン を参照）を送信できます。ユーザーはその組織の有効なメンバーであり、idp_org:read 権限を持っている必要があります。メンバーでないユーザーには 404 not_found を返し、組織の存在を開示しません。権限のないメンバーには 403 insufficient_permissions を返します。
@keenauth/js を使う場合：await keenauth.organizations.get(orgId)。
リクエスト
ヘッダー：
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子。 |
org_id：組織の識別子（org_…）。
ボディはありません。
レスポンス
200 OK と ETag: "<version>" が返されます。
| フィールド | 説明 |
|---|---|
id |
org_…。 |
name |
表示名。プレーンテキストとして表示してください。 |
slug |
組織のスラッグ。 |
status |
active、disabled、または pending_deletion。 |
brand_color |
#RRGGBB。未設定の場合は null。 |
deletion_due_at |
削除保留中の場合のみ：組織が削除される予定の日時。 |
created_at、updated_at |
RFC 3339 形式の日時。 |
version |
ETag に含まれるバージョン。更新時に If-Match として送信します。 |
エラー
| ステータス | コード | 条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 403 | insufficient_permissions |
ユーザーにその組織での idp_org:read 権限がありません。 |
| 404 | not_found |
このユーザーに対応する組織が存在しません。存在しない、形式が不正、または他の組織の識別子の場合も同じ応答になります。 |
| 503 | service_unavailable |
一時的に利用できません。Retry-After の後に再試行してください。 |
例
curl https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
{
"id": "org_01jbz6x8kq3m2n4p5r6s7t8v9a",
"name": "Acme",
"slug": "acme",
"status": "active",
"brand_color": "#112233",
"created_at": "2026-11-03T09:00:00Z",
"updated_at": "2026-11-03T09:30:00Z",
"version": 4
}