Change Institution Status

POST/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/status WEB

Changes the status of a specific institution. Used for lifecycle management such as activation, suspension, or closure.

Required Headers

Header	Example Value	Description
Content-Type	application/json	Request content type
Accept	application/json	Expected response type
X-Client-Hash		Client device fingerprint
Accept-Language	en, zh, zh-Hant, ja, vi	Response language (default: en)
Authorization	Bearer	JWT access token

Request Parameters

Path Parameters

Name	Type	Required	In	Description
workspaceId	string	Required	path	Workspace business ID
institutionBizId	string	Required	path	Institution business ID

Request Body

InstitutionStatusChangeRequest:

Name	Type	Required	In	Description
status	string	Required	body	New status: PENDING, REVIEWING, ACTIVE, REJECTED, SUSPENDED, CLOSED
reason	string	Optional	body	Reason for the status change (max 500 characters)

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "inst_abc123",
    "institutionName": "Acme Corp",
    "institutionDescription": "Main institution",
    "institutionRemark": null,
    "institutionType": "TENANT",
    "institutionStatus": "SUSPENDED",
    "extraConfig": null,
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T01:00:00Z"
  }
}

Error Responses

Code	Description
4000	Validation error (invalid status value)
4010	Unauthorized (invalid or missing JWT token)
4040	Institution not found
4090	Invalid state transition

Notes

• Not all status transitions are valid. The system enforces a state machine for institution lifecycle.
• CLOSED is a terminal state and cannot be transitioned out of.