---
title: "Remove assets from an album"
method: DELETE
path: "/api/albums/{album_id}/assets"
tags: ["albums"]
---

# Remove assets from an album

`DELETE /api/albums/{album_id}/assets`

## Request

- Base URL: `https://api.gumnut.ai`
- URL: `https://api.gumnut.ai/api/albums/{album_id}/assets`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Detaches one or more assets from the given album. The assets themselves remain in the library and in any other albums they belong to. Use `trash_assets` to soft-delete the asset entirely. To empty an album completely, call `list_album_assets` to get the links and then remove them, or delete the album itself with `delete_album`.

## Path parameters

- `album_id` string, required: Album ID (with `album_` prefix) of the album to detach assets from.

## Request body

- AlbumAssetAssociation
  - `asset_ids` string[], required: Asset IDs (with `asset_` prefix) to associate with the album. Up to 200 ids per request.

## Response `200`

Successful Response

- DeletionResponse: Empty acknowledgment returned when an operation succeeds.

## Other responses

- `401`: Missing, invalid, or expired credentials.
- `403`: The credentials are valid but not authorized for this operation — for example an API key whose action or library scope excludes it, or a credential type this operation does not accept.
- `404`: Not found
- `409`: Clerk sign-in could not be associated with the existing account. Resolve the identity conflict before retrying sign-in; repeated requests with unchanged verification and identity state will not resolve it.
- `422`: Validation Error
- `429`: Rate limit exceeded, or too many of your requests are already in progress. Retry after the interval in the `Retry-After` header.
- `503`: Authentication provider temporarily unavailable. Retry sign-in later.

## Changes

- **2026-10-16** `7c2860d9eb88`: 2 info
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
- **2026-08-08** `815e0302a988`: 1 breaking, 1 info
  - response property `detail` list-of-types was widened by adding types `string` to media type `application/json` of response `422`
  - the response property `detail` became required for the status `422`
- **2026-08-05** `c3e15c78f2da`: 4 info
  - added the media type `application/json` for the response with the status `404`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
- **2026-05-18** `9af798cdc7db`: 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`

[Operation history](https://skmtc.dev/gumnut-ai/apis/gumnut-api/changes/api/albums/:album_id/assets/delete.md)

---

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