Update Self Institution

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

Updates the institution that the current authenticated user belongs to. Supports partial update -- only non-null fields are modified.

Authentication

Requires a valid JWT token. Gateway validation: enableJwtToken=true, enableTurnstile=false.

Request Parameters

Path Parameters

Name	Type	Required	In	Description
workspaceId	string	Yes	path	Workspace business ID

Request Body

InstitutionUpdateRequest:

Name	Type	Required	In	Description
institutionBizId	string	Yes	body	Institution business ID to update
institutionName	string	No	body	New institution name (max 126 characters)
institutionDescription	string	No	body	New description (max 255 characters)
institutionRemark	string	No	body	New remark (max 255 characters)
extraConfig	object	No	body	Extra configuration (official profile and social media)

Success Response

Success200

{
  "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"
  }
}

Error Responses

Code	Description
4000	Validation error (missing institutionBizId, field size exceeded)
4010	Unauthorized (invalid or missing JWT token)
4040	Institution not found or user does not belong to this institution

Notes

• The user can only update their own institution.
• Only fields provided in the request body are updated; omitted fields remain unchanged.