Sign in

v64

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

Restore assets from trash

Restores trashed assets so they reappear in default list/search results. Idempotent — assets that are already live are silently skipped.

Pairs with trash_assets: assets soft-deleted there can be brought back here within the retention window. To restore a whole trashed library, use restore_library.

post/api/assets/restore

Query parameters

library_idstring nullable

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

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.