Permanently delete assets
Hard-deletes each specified asset — the database record, the stored file, and all associated data (faces, album links, etc.). Irreversible. Prefer trash_assets for the user’s standard delete action so accidents can be recovered.
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.