Change Institution Status

POST/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/statusWEB

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

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
institutionBizId	string	Yes	path	Institution business ID

Request Body

InstitutionStatusChangeRequest:

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

Success Response

Success200

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