Remove a channel
Take a channel off the allowlist. Use this when a creator leaves your product, or asks you to stop managing their channel.
DELETE/api/v4/allowlist/channels/{id}/
Path parameters
| Parameter | Description |
|---|---|
id | The id from the channel object, not the YouTube channel id. |
Headers
| Header | Required | Description |
|---|---|---|
X-User-ID | No | Required if the channel belongs to one of your end users. Without it the channel is not found, and nothing is removed. |
Example request
curl https://api.slipstreammusic.com/api/v4/allowlist/channels/9b5c3d2e-0a8e-4b7c-8c4d-2f9e5f6b8d7c/ \
-X DELETE \
-H "Authorization: Bearer $PARTNER_API_KEY"Response — 204 No Content
The response body is empty. The channel stops appearing in List channels straight away.
Removal is reversible: adding the same channel again restores the original entry, with the id it had before. The channel is also free to be registered by another account once you have removed it.
Errors
| HTTP | When |
|---|---|
| 401 | No credential, or the credential is not recognised |
| 403 | Channel management is not enabled on your account, or X-User-ID was sent from an account without end-user support |
| 404 | No channel with that id on this allowlist — including a channel belonging to an end user you did not name with X-User-ID, and one you have already removed |
| 406 | These endpoints only produce JSON. Send Accept: application/json or */* |
| 429 | Rate limit or usage allowance exceeded. Note that removals count against the same allowance as everything else on these endpoints |