> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# ワークスペースとメンバー

ワークスペースの切り替え、組織の管理、招待の処理。

## アクティブなワークスペースの解決

GET /api/workspaces はメンバーのワークスペースメンバーシップとアクティブなワークスペース ID を返し、ワークスペース ID を指定した POST で切り替えます。サーバーは選択 Cookie、保存済みの設定、個人ワークスペースの順でコンテキストを解決し、現在のメンバーシップを検証するため、偽造または古い選択で別のワークスペースを読むことはできません。


## 組織の管理

GET /api/mobile/organization はメンバー、保留中の招待、シート使用状況、呼び出し元の権限 — canManage と canLeave — を返します。個人ワークスペースの場合は代わりに notOrganization が返ります。POST は組織を作成し、PATCH は名前を変更し(owner のみ)、DELETE は削除します(owner のみ、名前を入力して確認)。

組織の画面は「設定 → メンバー」と「設定 → 一般」にあります。メンバー自身の表示名の編集は Better Auth のプロフィールルート経由で行われ、1〜100 文字を受け付けます。


## 招待と受諾

POST /api/mobile/invitations は admin、member、guest のいずれかのロールで招待をメール送信します — owner と admin のみ。型付きの失敗は alreadyMember、alreadyInvited、seatLimitExceeded、dailySendLimit、invalidInput をカバーするため、インターフェースは各拒否を説明できます。再送と取り消しは招待 ID のルートにあり、再送はレート制限されています。

受諾は <scheme>://invite/<token> ディープリンクで届きます。アプリはトークンを招待の受諾ルートに送信し、そのルートはワークスペース ID を返して、そのワークスペースをアクティブにし、設定をサーバー側に記録します。エラーは expired、emailMismatch、not-pending、seat-limit-exceeded をカバーします。


## ロール変更とメンバー削除

PATCH /api/mobile/members/:userId は owner、admin、member、guest のいずれかを割り当て、DELETE はメンバーを削除し、POST /api/mobile/members/leave は自分から退出します。唯一の owner は退出も降格もできず、メンバーは管理ルートで自分自身を削除できません。何も変えないロール変更は記録されずに拒否されます。


## 検証とトラブルシューティング

シート制限、取り消された招待リンク、guest ロールの制限された操作、個人ワークスペースへの切り替えをテストしてください。削除されたメンバーのキャッシュされた選択は、次のリクエストで閉じた状態で失敗する必要があり、古いワークスペースを読み続けてはいけません。


## 次へ

[AI チャットとアシスタント](https://supastack.dev/ja/docs/mobile/chat.md)