Disable Channel Type
POST
/web/v1/notification-channel-types/command/disable WEBDisables a notification channel type. No new channels of this type can be created while disabled.
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
Request Body
TypeStatusRequest:
| Name | Type | Required | In | Description |
|---|---|---|---|---|
bizId | string | Required | body | Type business ID to disable |
Success Response
Success 200
{
"code": "2000",
"message": "SUCCESS",
"data": {
"bizId": "ct_abc123",
"typeCode": "EMAIL",
"typeValue": 80010101,
"typeName": "Email Notification",
"typeDescription": "Standard email delivery",
"typeStatus": "DISABLED",
"displayOrder": 0,
"iconUrl": null,
"extraConfig": null,
"createdAt": "2026-03-21T00:00:00Z",
"updatedAt": "2026-03-21T01:00:00Z"
}
}Error Responses
| Code | Description |
|---|---|
4000 | Validation error (missing bizId) |
4010 | Unauthorized (invalid or missing JWT token) |
4030 | Turnstile verification failed |
4040 | Channel type not found |
Notes
- The channel type status changes to
DISABLED. - Existing channels of this type are not affected; only new channel creation is blocked.