Skip to main content
POST
Move assets to trash

Authorizations

Authorization
string
header
required

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_id
string | null

Library that owns the assets. Optional if the user has a single live (non-trashed) library; required when they have multiple.

Body

application/json

Request body carrying a list of asset IDs for the bulk trash, restore, and permanent-delete endpoints.

ids
string[]
required

Asset IDs (each with the asset_ prefix) to operate on. Up to 200 ids per request.

Required array length: 1 - 200 elements

Response

Successful Response

Empty acknowledgment returned when an operation succeeds.