v64

OpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB

albums

Remove assets from an album

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.

Up to 200 ids per request; over-cap requests return 422.

delete/api/albums/{album_id}/assets

Path parameters

album_idstring required

Album ID (with album_ prefix) of the album to detach assets from.

Request body

asset_idsstring[] required

Asset IDs (with asset_ prefix) to associate with the album. Up to 200 ids per request.

Response

Successful Response

DeletionResponse required

Acknowledgment body returned by destructive endpoints (delete / trash / restore / permanently delete / remove-from-album / empty-trash).

Carries no fields — the HTTP 200 + empty JSON object is itself the success signal. Exists so MCP tools generated from these endpoints have a real outputSchema (rather than the null schema FastMCP emits for 204 responses), which ChatGPT's MCP submission tooling requires.