API 参考 / orgs

我所属的组织

GET /api/v1/orgs · listOrgs

当前用户所属的全部 active 组织。PAT 不可调用本端点：PAT 的归属模型是 「一个用户 × 一个项目」，组织面天然跨项目、跨组织，在这个模型里没有位置。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

响应字段 · 200

items（必填）

OrgSummary[]

items[].id（必填）

string

items[].name（必填）

string

items[].role（必填）

enum；取值：admin / member

错误

• 401：Problem 错误响应

请求示例（curl）

curl -X GET "https://workflow.games/api/v1/orgs" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "role": "admin"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引