Delete one superseded version
Drops slug@version from the preset's history. After it, that reference is 404 preset_not_found for good — nothing else changes: the preset keeps running whatever version it ran, the numbering is untouched (the next version is always current + 1, so a deleted number is never reissued), and a job that ran this version keeps its own copy of what it ran.
USE THIS WHEN:
- A preset is at its version ceiling (422 resource_limit_exceeded on PUT) and you know which earlier versions nothing pins
- A stored version carries a prompt you want gone
DO NOT USE WHEN:
- Anything might still call slug@version — a pinned reference stops resolving, and that is the whole cost of this call
To move what an UNPINNED call runs, PUT the old steps as a new version instead.
Request
- Base URL: https://api.imagestep.dev
- URL: https://api.imagestep.dev/api/v1/presets/{slug}/versions/{version}
- Auth: API key in header Authorization
Path parameters
Preset slug or id — without an @, the version is the path segment below
The superseded version to delete
Headers
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.