チャンネルの削除

Prev Next

Classic/VPC環境で利用できます。

チャンネルを削除します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
DELETE /v1/api/channels/{channelId}

リクエストヘッダ

Ncloud Chat APIで共通して使用されるヘッダの詳細は、Ncloud Chatのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
channelId String Required チャンネル ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request DELETE 'https://dashboard-api.ncloudchat.naverncp.com/v1/api/channels/dad2bea7-****-****-****-307a791a7102' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project ID}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
channel Object - チャンネル情報
channel.id String - チャンネル ID
channel.project_id String - プロジェクト ID
channel.name String - チャンネル名
channel.user_id String - チャンネル作成者 ID
channel.user Object - 作成者情報
channel.user.id String - チャンネル作成者 ID
channel.user.name String - 作成者名
channel.user.profile String - 作成者のプロファイル画像
channel.unique_id String - チャンネル固有 ID
  • 固有の識別目的でユーザーが入力する ID
channel.type String - チャンネルタイプ
  • PUBLIC | PRIVATE
    • PUBLIC: 公開
    • PRIVATE: 非公開
channel.translation Boolean - 自動翻訳するか
  • true | false
    • true: 翻訳
    • false: 翻訳しない
channel.members Array - 購読可能なユーザー IDリスト
  • typeがPRIVATEの場合、有効値を表示
channel.disabled Boolean - 無効化かどうか
  • true | false
    • true: 無効化
    • false: 有効化
channel.mutes Boolean - ミュートするか
  • true | false
    • true: ミュート
    • false: ミュートしない
channel.push Boolean - プッシュ通知を許可するか
  • true | false
    • true: 許可
    • false: ブロック
channel.limit Integer - 最大参加人数
  • 0: 無制限
channel.link_url String - チャンネルリンク URL
channel.image_url Array - チャンネル画像 URL
channel.created_at String - チャンネルの作成日時
  • ISO 8601形式
channel.updated_at String - 情報更新日時
  • ISO 8601形式
status Integer - レスポンスの状態
  • 1: 成功
  • 1でない場合: 失敗

レスポンスステータスコード

Ncloud Chat APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Chatのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "channel": {
        "id": "dad2bea7-****-****-****-307a791a7102",
        "project_id": "8be54b8b-****-****-****-84c0d5df2e9c",
        "name": "channelnamee",
        "user_id": "d71157d7-****-****-****-3c4cd4fef46e",
        "user": {
            "id": "TWVtYmVycz************************************RjZDRmZWY0NmU=",
            "name": "Admin",
            "profile": ""
        },
        "unique_id": "unique Id",
        "type": "PRIVATE",
        "translation": true,
        "members": [],
        "disabled": false,
        "mutes": false,
        "push": true,
        "limit": 20,
        "link_url": "{Link URL}",
        "image_url": "{Image URL}",
        "created_at": "2025-07-23T15:40:37+09:00",
        "updated_at": "2025-07-23T16:55:17+09:00"
    },
    "status": 1
}