Preset Management

Delete a preset

Deletes the preset and every version of it; every slug@N a caller holds answers 404 preset_not_found from then on. A job that already ran keeps its own copy of what it ran. Built-ins are 403.

delete/api/v1/presets/{slug}

Request

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

Path parameters

slugstring required

Preset slug or 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.