Sign in
assets

Permanently delete an asset

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}

Path parameters

asset_idstring required

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

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

Response

Successful Response

DeletionResponse required

Empty acknowledgment returned when an operation succeeds.

Changes

Changed in 3 of the 79 revisions of this API.26

  • 815e0302a98811See 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 became required for the status

      response-property-became-required

  • c3e15c78f2da4See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

  • 9af798cdc7db11See the full diff
    • ▲

      removed the success response with the status

      response-success-status-removed

    • ○

      added the success response with the status

      response-success-status-added