---
title: "Remove YouTube channels from the whitelist"
method: DELETE
path: "/api/v1/content_id/channels"
tags: ["Content ID"]
---

# Remove YouTube channels from the whitelist

`DELETE /api/v1/content_id/channels`

Removes up to 50 channels per request. Pass canonical channel IDs (`UC…`)
exactly as returned by the list endpoint. IDs that are not on the
whitelist are ignored.

## Query parameters

- `channel_ids[]` string[], required

## Headers

- `Authorization` string, required

## Response `200`

Updated whitelist license state

- ContentIdWhitelistResource
  - `data` object
    - `id` string — Whitelist license code (same value as meta.license.code on the channel list endpoint).
    - `type` string
    - `attributes` object
      - `status` 'active' | 'inactive' | 'expired' | 'quota_reached' — License status. quota_reached means the single-use code has been consumed.
      - `expiration_date` string, date, nullable — Inclusive: the last day whose uploads are covered. null means the license does not expire.
      - `channels_count` integer

## Other responses

- `403` — Missing or invalid API token
- `404` — No whitelist license exists yet
- `422` — channel_ids missing, not an array, or more than 50 IDs
- `503` — Licensing service temporarily unavailable — retry the request

---

[API](https://skmtc.net/melod/apis/melodie-api.md) · [All operations](https://skmtc.net/melod/apis/melodie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melod/melodie-api/revisions/06cd6e66c531/schema)