Enterprise API

Enterprise 接口使用 /v1/auth/login 返回的用户 JWT（pb_usr_*）。除非接口单独说明 API key scope，否则组织和成员管理需要 Enterprise owner。

企业资料

• GET /v1/enterprise 返回当前 Enterprise 资料。
• PATCH /v1/enterprise 更新 name、billing_email 或 plan，仅 owner 可用。

组织

• GET /v1/enterprise/orgs 查看当前 Enterprise 下的组织。
• POST /v1/enterprise/orgs 新建组织，支持可选 id 和 name。该接口支持 Enterprise owner JWT，也支持带 enterprise:write 的 API key。
• DELETE /v1/enterprise/orgs/{id} 删除组织；当前组织或仍有关联用户的组织不能删除。
• POST /v1/enterprise/orgs/{id}/api-keys 为同一个 Enterprise 下的子组织创建 API key。该接口需要 enterprise:write，secret 只会在创建响应里返回一次。

成员

• GET /v1/enterprise/members 查看 Enterprise 用户，包括 disabled 成员。
• PATCH /v1/enterprise/members/{id} 更新 enterprise_role 和/或 organization_id，仅 owner 可用。
• DELETE /v1/enterprise/members/{id} 禁用用户账号，非硬删除，仅 owner 可用。

角色为 owner、admin 或 member。API 会阻止禁用自己，也会阻止禁用或降级最后一个 active owner。

disabled 用户不能登录；账号被禁用后，已有用户 JWT 也会被拒绝。

邀请

• POST /v1/enterprise/invitations 基于 email、organization_id、role 和 expires_hours 创建邀请。
• POST /v1/enterprise/invitations/{token}/accept 使用有效邀请创建 active Enterprise 用户。

admin 只能邀请用户加入自己的组织，且不能邀请 owner。

用量

• GET /v1/enterprise/usage 返回 Enterprise 下组织、电脑、打印机和任务的汇总数量。

打印记录

• GET /v1/enterprise/print-jobs 返回当前 Enterprise 下所有子组织的打印记录，任意 Enterprise 成员都可以查看。
• Enterprise 本身不直接创建打印任务；创建任务仍使用组织维度的 API key 或用户会话调用 /v1/print-jobs。