libraries

Move a library to trash

Moves the library and all its contents into the trash. The library becomes inaccessible by default and can be fully restored within 90 days by calling restore_library. After 90 days the library's assets are gradually purged in the background; until the library row itself is removed, restore still works but recovers only the assets not yet purged.

Idempotent — a second call on an already-trashed library no-ops. To trash individual assets without trashing the whole library, use trash_assets instead.

post/api/libraries/{library_id}/trash

Path parameters

library_idstring required

Library ID (with lib_ prefix) of the library to trash.

Response

Successful Response

DeletionResponse required

Empty acknowledgment returned when an operation succeeds.

Changes

Changed in 4 of the 79 revisions of this API.27

Aug 8, 2026815e0302a98811See 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
Aug 5, 2026c3e15c78f2da4See 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
May 18, 20269af798cdc7db11See 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
May 18, 2026fbb16c77784c1See the full diff
- ○
  endpoint added
  endpoint-added

Full history