API 参考 / onboarding

Step 1 确认项目角色

POST /api/v1/onboarding/roles/confirm · confirmOnboardingRoles

确认或修改默认角色。完成条件：至少一个管理能力角色且创建者属于该角色。

鉴权：项目 API Token（Authorization: Bearer wfp_…）。详见 Agent 接入。

响应字段 · 200

projectId（必填）

string

completed（必填）

boolean

completedAt

string

canManage（必填）

boolean —— 当前用户是否具备项目管理能力；初始化期具备者进入引导，否则只能看到正在初始化提示（文档 §7.3）

steps（必填）

OnboardingStep[]

steps[].key（必填）

enum；取值：roles / invitations / acceptance / complete

steps[].label（必填）

string

steps[].status（必填）

enum；取值：pending / done

错误

• 409：Problem 错误响应

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/onboarding/roles/confirm" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "projectId": "018f3c2e-0000-7000-8000-000000000000",
  "completed": true,
  "canManage": true,
  "steps": [
    {
      "key": "roles",
      "label": "示例文本",
      "status": "pending"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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