组织与企业¶

组织与企业是仓库的归属空间。通过 API 可以创建组织、查询与更新组织资料，管理组织成员、成员关系（memberships）与自定义角色，并查询企业成员及其角色权限。

组织（org）与企业（enterprise）是两条并列的路径前缀，成员接口两边都有，字段与角色枚举不完全相同。

对象¶

标识方式¶

• 组织用路径参数 org 标识（组织路径），企业用 enterprise 标识。
• 成员用 username 标识；授权用户在组织内的身份用 /user/memberships/orgs/{org} 表示。
• 用户所属组织有 /users/{username}/orgs 与 /users/orgs 两个入口，后者是当前授权用户。

常见任务¶

注意事项¶

• 邀请与移除成员用的是同一条路径 …/orgs/{org}/memberships/{username}，靠 HTTP 方法区分：POST 邀请、DELETE 移除。
• 「列出授权用户所属的组织」是 GET /api/v5/users/orgs，路径里没有 {username}；带 {username} 的版本查的是任意用户的公开组织。
• 退出组织、查询自己在组织内的成员资料走 /api/v5/user/memberships/orgs/{org}，属于「授权用户视角」，不在 /orgs/ 下。
• 企业侧成员接口前缀是 /api/v5/enterprises/{enterprise}/…，与组织侧 /api/v5/orgs/{org}/… 并列，角色枚举也不同（企业侧含浏览者、测试人、研发等）。
• 组织的 Issue 状态与看板配置有独立接口，Issue 本身的接口在 Issue 分组。

接口列表¶

本模块共 17 个接口。