Update Channel Type

POST/web/v1/notification-channel-types/command/update WEB

Updates an existing notification channel type. Supports partial update.

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

NotificationChannelTypeUpdateRequest:

Name	Type	Required	In	Description
bizId	string	Required	body	Type business ID (max 64 characters)
typeName	string	Optional	body	New type name (max 128 characters)
typeDescription	string	Optional	body	New type description (max 512 characters)
typeStatus	string	Optional	body	New status: ENABLED, DISABLED
displayOrder	integer	Optional	body	New display sort order
iconUrl	string	Optional	body	New icon URL (max 512 characters)
extraConfig	string	Optional	body	New extra configuration as JSON string

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ct_abc123",
    "typeCode": "EMAIL",
    "typeValue": 80010101,
    "typeName": "Updated Email Type",
    "typeDescription": "Updated description",
    "typeStatus": "ENABLED",
    "displayOrder": 1,
    "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

• Only non-null fields are updated; omitted fields remain unchanged.