> ## 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 重命名（仅所有者），DELETE 删除（仅所有者，需输入名称确认）。

组织界面位于“设置 → 成员”与“设置 → 通用”；成员自己的显示名修改走 Better Auth 的 profile 路由，接受 1 到 100 个字符。


## 邀请与接受

POST /api/mobile/invitations 以邮件发出角色为 admin、member 或 guest 的邀请 —— 仅所有者与管理员可用。带类型的失败涵盖 alreadyMember、alreadyInvited、seatLimitExceeded、dailySendLimit 与 invalidInput，界面可以据此解释每种拒绝。重发与撤销位于邀请 id 路由上，且重发有速率限制。

接受动作通过 <scheme>://invite/<token> 深链接到达：应用把 token 提交到邀请接受路由，后者返回工作区 id、激活该工作区，并在服务端记录此偏好。错误涵盖 expired、emailMismatch、not-pending 与 seat-limit-exceeded。


## 变更角色与移除成员

PATCH /api/mobile/members/:userId 指派 owner、admin、member 或 guest 角色；DELETE 移除成员；POST /api/mobile/members/leave 主动退出。唯一所有者不能退出或被降级，成员不能通过管理路由移除自己，未产生任何变化的角色修改会被拒绝而非记录。


## 验证与排障

测试席位上限、已撤销的邀请链接、guest 角色被削减的操作，以及切回个人工作区。被移除成员的缓存选择必须在下一次请求时失败关闭，而不是继续读取旧工作区。


## 下一篇

[AI 聊天与助手](https://supastack.dev/zh/docs/mobile/chat.md)