Sign in
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.

Changes

Changed in 3 of the 79 revisions of this API.26

  • 815e0302a98811See the full diff
    • ▲

      response property detail list-of-types was widened by adding types string to media type application/json of response 422

      response-property-list-of-types-widened

    • ○

      the response property detail became required for the status 422

      response-property-became-required

  • c3e15c78f2da4See the full diff
    • ○

      added the media type application/json for the response with the status 404

      response-media-type-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

  • 9af798cdc7db11See the full diff
    • ▲

      removed the success response with the status 204

      response-success-status-removed

    • ○

      added the success response with the status 200

      response-success-status-added