assets

Permanently delete an asset

Changed on

Deletes the asset entirely — 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.

Use remove_assets_from_album instead when the user only wants to remove an asset from a specific album but keep the file in their library. Use delete_album to remove an album without deleting its assets.

delete/api/assets/{asset_id}

Request

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

Path parameters

asset_idstring required

Asset ID (with asset_ prefix) of the asset to permanently delete.

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