assets

Restore assets from trash

Changed on

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

Request

  • Base URL: https://api.gumnut.ai
  • URL: https://api.gumnut.ai/api/assets/restore
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

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.

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

  • 7c2860d9eb88Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 815e0302a988Revision changes
    • breaking

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

    • info

      the response property became required for the status