API 参考 / me

更新我的个人资料

PATCH /api/v1/me/profile · updateMyProfile

整份覆盖当前用户的自定义显示名与头像(修复规格「已锁产品决策 3」)。这是用户自己维护的资料, 与项目成员关系、飞书身份都正交:一旦自定义,后续飞书侧的名称 / 头像变化不会自动覆盖。 两个字段都必填、整份覆盖(读当前 → 改一处 → 整份写),空串表示「清除自定义、回落飞书身份」。 头像只接受本站已上传附件的路径或空串,不接受任意外链(防 SSRF / 追踪像素)。

鉴权:项目 API Token(Authorization: Bearer wfp_…)。详见 Agent 接入。

请求体

displayName(必填)
string
avatarUrl(必填)
string

响应字段 · 200

userId(必填)
string
email(必填)
string
emailVerified(必填)
boolean
orgs(必填)
OrgSummary[]
orgs[].id(必填)
string
orgs[].name(必填)
string
orgs[].role(必填)
enum;取值:admin / member
lastActiveOrgId
string
hasCreatedOrg(必填)
boolean
displayName
string
avatarUrl
string
avatarSource
enum;取值:custom / feishu / none
platformRole(必填)
enum;取值:user / superadmin

错误

请求示例(curl)

curl -X PATCH "https://workflow.games/api/v1/me/profile" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"displayName":"示例标题","avatarUrl":"https://example.com"}'

响应示例

HTTP/1.1 200
{
  "userId": "018f3c2e-0000-7000-8000-000000000000",
  "email": "[email protected]",
  "emailVerified": true,
  "orgs": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "role": "admin"
    }
  ],
  "hasCreatedOrg": true,
  "platformRole": "user"
}

合同真值:OpenAPI 3.1(0.1.0)。

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

Workflow 正在加载…