v64

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

assets

Move assets to trash

Soft-deletes the given assets. Trashed assets are excluded from default list/search results and are purged after the configured retention window. Reversible via restore_assets until purge.

Use this for the user's standard 'delete' action — there is no MCP-exposed permanent-delete tool, so trash is the only path. To trash an entire library at once instead of enumerating asset IDs, use trash_library.

post/api/assets/trash

Query parameters

library_idstring nullable

Library that owns the assets. Optional if the user has a single library; required when they have multiple.

Request body

idsstring[] required

Asset IDs (each with the asset_ prefix) to operate on. 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.