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

2c3aca3a6e6d

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.

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 live (non-trashed) library; required when they have multiple.

Library that owns the assets. Optional if the user has a single live (non-trashed) 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

Empty acknowledgment returned when an operation succeeds.