更新机构

POST/web/v1/workspaces/{workspaceId}/institutions/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": "Acme Corp 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	机构未找到

说明

• 仅更新请求体中提供的字段；未提供的字段保持不变。
• 至少须提供一个可更新字段。