Preset Management

List presets

Built-in presets first, then your own, most recently updated first. Each entry is the current version — what the preset runs now — and usage, how much it is being run.

NOT PAGED: the built-ins and every preset of yours (an account holds at most 1000) come back in one answer, with no meta.

NO HISTORY BY DEFAULT: versions is left off, and versionCount says how many there are (the current one plus every superseded one). Read one preset's snapshots with GET /api/v1/presets/{slug}, or pass ?includeVersions=true here for the export shape of every preset at once — which is what POST /api/v1/presets/import takes back.

USE THIS WHEN:

  • Choosing a preset to run, or listing what an account has saved

DO NOT USE WHEN:

  • You know the slug → GET /api/v1/presets/{slug}

FILTER: omit for both, builtin for the shipped ones only, user for your own only.

get/api/v1/presets

Request

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

Query parameters

filter'builtin' | 'user'

Filter by source: 'builtin' or 'user'. Omit to return all.

includeVersionsboolean

Include each preset's superseded versions — the export shape. Off by default: a list row is read to choose a preset, and its history is up to 50 snapshots per preset.

Response

Every preset the filter selects, built-ins first

Changes

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