---
title: "Deletes a playlist."
method: DELETE
path: "/playlists/{playlist_urn}"
tags: ["playlists"]
---

# Deletes a playlist.

`DELETE /playlists/{playlist_urn}`

## Request

- Base URL: `https://api.soundcloud.com`
- URL: `https://api.soundcloud.com/playlists/{playlist_urn}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://secure.soundcloud.com/authorize`
    - Client credentials
    - Token URL: `https://secure.soundcloud.com/oauth/token`
- TypeScript: <https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/docs/playlists/:playlist_urn/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `playlist_urn` string, required

## Response `200`

Success

## Other responses

- `404`: Not Found

## Changes

- **2026-07-17** `ab7b2ffc0193`: 1 breaking, 1 info
  - the `errors/items/` response's property type changed from `string` to `object` for status `404`
  - added the optional property `errors/items/error_message` to the response with the `404` status

[Operation history](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/changes/playlists/:playlist_urn/delete.md)

---

[API](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification.md) - [All operations](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/revisions/0d057017b405?raw)