Disable Turnstile

POST/web/v1/system/workspaces/{workspaceId}/institutions/{institutionBizId}/portals/turnstile/disable WEB

Disables Cloudflare Turnstile verification for the specified institution. After disabling, portal login flows will no longer require Turnstile challenge completion.

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

No request body required.

Success Response

Success 200

{
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "id": 1,
    "institutionBizId": "INST_ACME_001",
    "turnstileSiteKey": "0x4AAAAAAABkMYinukE8nMDQ",
    "turnstileSecretKey": "****nMDQ",
    "enabled": false,
    "remark": "Production turnstile",
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-23T10:30:00Z"
  }
}

Response Fields

Field	Type	Description
id	number	Internal record ID
institutionBizId	string	Institution business ID
turnstileSiteKey	string	Cloudflare Turnstile site key
turnstileSecretKey	string	Masked secret key (only last 4 characters visible)
enabled	boolean	Always false after this operation
remark	string|null	Configuration remark
createdAt	string	ISO 8601 creation timestamp
updatedAt	string	ISO 8601 last update timestamp

Error Responses

Code	Description
4010	Unauthorized (invalid or missing JWT token)
4040	Institution or turnstile configuration not found

Notes

• The Turnstile configuration and keys are preserved. Only the enabled flag is set to false.
• If Turnstile is already disabled, this operation is idempotent and returns the current state.
• The turnstileSecretKey is masked in the response (format: ****xxxx).
• To re-enable, use Enable Turnstile.