SuperAPI AI 工具集

workos

编程与开发

查看项目

更新于 10-16 02:36

技能介绍

用途:本技能封装 WorkOS API,供在用户提及 WorkOS、SSO、SAML、SCIM 等场景时调用,管理企业组织、单点登录连接、目录同步、用户、成员关系、审计日志与角色权限。

主要能力:组织(Organization)的列出、查询、创建与删除,含 id、name、domains、created_at;SSO Connections 的列出(可按 organization_id 过滤)、查询与删除;SCIM Directory Sync 的目录、目录用户、目录组的列出与查询;User Management 用户的列出、查询、创建、更新与删除,支持 email、organization_id、limit、after 过滤;Organization Memberships 的列出、创建与删除;Audit Logs 通过创建导出任务异步生成 CSV;Roles 的列出与查询。

使用方式:基础 URL 为 https://api.workos.com,所有请求需 Authorization: Bearer $WORKOS_TOKEN。环境变量 WORKOS_TOKEN 为 WorkOS 密钥(sk_live_... 或 sk_test_...)。需先在 app.vm0.ai/connectors 连接 WorkOS 连接器。列表示例:curl -s "https://api.workos.com/organizations" --header "Authorization: Bearer $WORKOS_TOKEN"。列表端点支持游标分页,使用 after 与 limit(默认 10,最大 100),响应含 list_metadata.after。审计日志先 POST /audit_logs/exports,再轮询导出 id 直到 state 为 ready,最后从响应 url 字段下载 CSV。

适用场景:需要为企业应用接入 SAML/SSO、同步 SCIM 目录、做细粒度 RBAC 或导出审计日志的自动化流程。

限制与注意:生产用 sk_live_...,测试用 sk_test_...,测试环境组织与用户相互独立;SSO 连接和目录同步以组织为范围,操作前应先取得 organization ID;WorkOS 按环境限流,遇到 429 需指数退避。请求失败可运行 zero doctor check-connector --env-name WORKOS_TOKEN 或 zero doctor check-connector --url https://api.workos.com/organizations --method GET 排查。官方文档:https://workos.com/docs/reference。