For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/mobile/workspaces.md (or send Accept: text/markdown).
ワークスペースとメンバー
ワークスペースの切り替え、組織の管理、招待の処理。
アクティブなワークスペースの解決
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 ロールの制限された操作、個人ワークスペースへの切り替えをテストしてください。削除されたメンバーのキャッシュされた選択は、次のリクエストで閉じた状態で失敗する必要があり、古いワークスペースを読み続けてはいけません。