v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB
albums

Delete an album

Deletes the album itself. Assets that were in the album remain in the library — only the album and its asset-links are removed. Use trash_assets to soft-delete the underlying assets, or remove_assets_from_album to detach specific assets from an album you want to keep.

delete/api/albums/{album_id}

Path parameters

album_idstring required

Album ID (with album_ prefix) of the album to delete.

Album ID (with album_ prefix) of the album to delete.

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.