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.
Authorizations
Gumnut API key (apikey_...) sent as a Bearer token in the Authorization header. Create and manage keys in the Gumnut app, or with the API key endpoints while signed in to it.
Query Parameters
Library that owns the assets. Optional if the user has a single live (non-trashed) library; required when they have multiple.
Body
Request body carrying a list of asset IDs for the bulk trash, restore, and permanent-delete endpoints.
Asset IDs (each with the asset_ prefix) to operate on. Up to 200 ids per request.
1 - 200 elementsResponse
Successful Response
Empty acknowledgment returned when an operation succeeds.