Asset Management

Batch delete assets permanently

Deletes multiple assets and queues their stored objects for removal. Final — there is no trash and no restore. IDs that are not yours, or no longer exist, are skipped without an error: deleted lists what was actually deleted. A published asset's publicUrl stops answering within about two minutes.

USE THIS WHEN:

Deleting specific assets by IDs

DO NOT USE WHEN:

Letting assets lapse on their own → do nothing; each is deleted at its expiresAt

post/api/v1/assets/delete

Request

Base URL: https://api.imagestep.dev
URL: https://api.imagestep.dev/api/v1/assets/delete
Auth: API key in header Authorization

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".

Request body

idsstring[] required

Asset IDs to delete permanently, at most 10000

Example request

{
  "ids": [
    "ast_…",
    "ast_…"
  ]
}

Response

What was deleted

Changes

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