Deactivate Notification Channel

POST/web/v1/notification-channels/command/deactivateWEB

Deactivates a notification channel. Notifications will be queued but not delivered while the channel is inactive.

Authentication

Requires a valid JWT token and Turnstile verification. Gateway validation: enableJwtToken=true, enableTurnstile=true.

Request Parameters

Request Body

ChannelStatusRequest:

Name	Type	Required	In	Description
bizId	string	Yes	body	Channel business ID to deactivate

Success Response

Success200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ch_abc123",
    "institutionBizId": "inst_abc123",
    "channelName": "Main Email",
    "channelRemark": null,
    "channelHost": "smtp.example.com",
    "channelCategory": "EMAIL",
    "channelStatus": "INACTIVE",
    "emailConfig": {
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "senderEmail": "noreply@example.com",
      "senderName": "Acme Corp",
      "username": "noreply@example.com",
      "password": "******",
      "useSsl": true,
      "useStartTls": false,
      "connectionTimeout": 10000,
      "readTimeout": 30000
    },
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T01:00:00Z",
    "createdBy": "user_xyz",
    "updatedBy": "user_xyz"
  }
}

Error Responses

Code	Description
4000	Validation error (missing bizId)
4010	Unauthorized (invalid or missing JWT token)
4030	Turnstile verification failed
4040	Channel not found

Notes

• The channel status changes to INACTIVE.
• Notifications will be queued while the channel is inactive.