Move a library to trash
Moves the library and all its contents into the trash. The library becomes inaccessible by default and can be fully restored within 90 days by calling restore_library. After 90 days the library’s assets are gradually purged in the background; until the library row itself is removed, restore still works but recovers only the assets not yet purged.
Idempotent — a second call on an already-trashed library no-ops. To trash individual assets without trashing the whole library, use trash_assets instead.
Path Parameters
Library ID (with lib_ prefix) of the library to trash.
Response
Successful Response
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.