更新自身机构

POST/web/v1/workspaces/{workspaceId}/institutions/self/updateWEB

更新当前已认证用户所属的机构。支持部分更新——仅修改非 null 的字段。

鉴权

需要有效的 JWT token。网关验证：enableJwtToken=true，enableTurnstile=false。

请求参数

路径参数

Name	Type	Required	In	Description
workspaceId	string	Yes	path	工作空间业务 ID

请求体

InstitutionUpdateRequest:

Name	Type	Required	In	Description
institutionBizId	string	Yes	body	要更新的机构业务 ID
institutionName	string	No	body	新机构名称（最多 126 个字符）
institutionDescription	string	No	body	新描述（最多 255 个字符）
institutionRemark	string	No	body	新备注（最多 255 个字符）
extraConfig	object	No	body	额外配置（官方资料和社交媒体）

成功响应

成功200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "inst_abc123",
    "institutionName": "My Institution Updated",
    "institutionDescription": "Updated description",
    "institutionRemark": null,
    "institutionType": "TENANT",
    "institutionStatus": "ACTIVE",
    "extraConfig": null,
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T01:00:00Z"
  }
}

错误响应

错误码	描述
4000	验证错误（缺少 institutionBizId、字段长度超限）
4010	未授权（无效或缺少 JWT token）
4040	机构未找到或用户不属于该机构

说明

• 用户只能更新自己所属的机构。
• 仅更新请求体中提供的字段；未提供的字段保持不变。