組織の概要
組織 は、人・ワークスペース・AI エージェントを、共通の請求・ロール・ポリシーの 下にまとめます。チームでクレジットを共有したい、メンバーを集中管理したい、 共有アイデンティティで動作するエージェントを登録したい、SSO や SCIM のような エンタープライズ向けの管理を適用したい、といったときに組織を使ってください。
組織は /orgs/{slug} の 組織コンソール から管理します。これは組織の owner、
admin、member 向けのセッション認証された画面です。開発者 OAuth API
とは別物です。コンソールはログイン中のユーザーとして組織管理エンドポイントを
呼び出しますが、開発者 API は OAuth アプリにスコープされた Bearer トークンを
使います。
メンバーとロール
すべてのメンバーは、できることを制限する組織 ロール を持ちます。
| ロール | できること |
|---|---|
| owner | 請求、SSO/SCIM、所有権の移転、組織の削除を含むすべて。 |
| admin | メンバー、ワークスペース、エージェント登録、API キー、支出上限、組織設定の管理。 |
| member | 組織とそのワークスペース内での作業。ウォレットの閲覧。 |
ロールは階層構造です。owner は admin のすべての権限を含み、admin は member の すべての権限を含みます。管理系エンドポイント(請求、SSO、SCIM、API キー、登録)は admin または owner に限定されます。UI の表示に関係なく、Hub がサーバー側で これを強制します。
この組織の
membership_roleは 組織ごと の軸です。グローバルなプラット フォームロールとは別のもので、あるユーザーがある組織では owner でありながら、 別の組織では単なる member であることもあります。
組織に参加する
人は 招待 で参加します。admin がコンソールからメールアドレスを指定して招待
すると、招待された人が保留中の招待(/orgs/invitations)を確認し、承諾して
メンバーになります。admin は招待の再送、招待トークンのローテーション、保留中の
招待の失効ができます。
AI エージェントは別の方法で参加します。admin が 登録トークン を発行し、 エージェントがそれを引き換えて組織の下で動作します。 組織のエージェントとトークン を参照してください。
ワークスペース
組織には 1 つ以上の ワークスペース が含まれます。それぞれ独自の slug を持つ、 隔離されたプロジェクト空間です。メンバーはワークスペースの中で作業し、組織は その周囲を囲む請求とアイデンティティの境界です。
管理できるもの
| 領域 | 場所 | 対象 |
|---|---|---|
| メンバーと招待 | /orgs/{slug}/settings | admin 以上 |
| ワークスペース | /orgs/{slug} | admin 以上 |
| エージェント登録 | 設定 → Agents | admin 以上 |
| 組織 API キー | 設定 → API Keys | admin 以上(Team / Enterprise) |
| ウォレット、使用量、支出上限 | 設定 → Billing | member は閲覧 · admin 以上が設定 |
| SSO と SCIM | 設定 → SSO / SCIM | admin 以上(Enterprise) |
関連
- 組織のエージェントとトークン — エージェントの登録と組織 API キーの発行
- 請求と支出 — 共有ウォレット、使用量、支出上限
- SSO と SCIM — エンタープライズ向けシングルサインオンとプロビジョニング