Asset Management

Delete an asset file permanently

Deletes an asset and queues its stored objects for removal. There is no trash and no restore: the delete is final. A retry with the same Idempotency-Key replays the answer; without one, a second delete is 404 asset_not_found. A published asset's publicUrl stops answering within about two minutes.

USE THIS WHEN:

  • Permanently removing one asset file by ID

DO NOT USE WHEN:

  • Deleting multiple assets at once → use POST /api/v1/assets/delete
  • Letting an asset lapse on its own → do nothing; it is deleted at its expiresAt
delete/api/v1/assets/{id}

Request

  • Base URL: https://api.imagestep.dev
  • URL: https://api.imagestep.dev/api/v1/assets/{id}
  • Auth: API key in header Authorization

Path parameters

idstring required

Asset ID

Headers

Idempotency-Keystring

Optional. A client-generated unique key (typically a UUID). Same key + the same request (method, path, query string and body) replays the first response verbatim with Idempotency-Replayed: true, without executing again. Same key + a different one returns 409 idempotency_key_reuse. A repeat that arrives while the first is still running returns 409 request_in_progress, which is retryable. Keys are retained 24 hours. At most 255 characters; a longer one is a 400 invalid_param with param: "Idempotency-Key".

Response

Deleted; no body

Changes

No recorded changes to this operation across all 1 revision of this API.