---
title: "Delete an album"
method: DELETE
path: "/users/{user_id}/albums/{album_id}"
tags: ["Albums\\Essentials"]
---

# Delete an album

`DELETE /users/{user_id}/albums/{album_id}`

## Request

- Base URL: `https://api.vimeo.com`
- URL: `https://api.vimeo.com/users/{user_id}/albums/{album_id}`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`, token URL `/oauth/access_token`
  - Client credentials, token URL `/oauth/authorize/client`
  - Scopes: `delete`
- TypeScript: <https://skmtc.dev/vimeo/apis/vimeo-api/docs/users/:user_id/albums/:album_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

This method deletes an album from the owner's account.

## Path parameters

- `album_id` number, required
- `user_id` number, required

## Response `204`

The album was deleted.

## Other responses

- `403`: The supplied token doesn't have the proper scopes, or the authenticated user can't delete the album.
- `404`: No such album exists.

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) - [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vimeo/apis/vimeo-api/revisions/ea882e0224a4?raw)