List Presets

GET /api/v1/presets

Retrieve a paginated list of presets. Returns your user-created presets along with system presets, ordered by system presets first, then by creation date descending.

Authentication

Requires API key via X-API-KEY header.

Request

Headers

Header	Type	Required	Description
`X-API-KEY`	`string`	Yes	Your API key with `ffsk_` prefix

Query parameters

Parameter	Type	Required	Default	Description
`limit`	`number`	No	`50`	Maximum number of presets to return. Max `100`.
`offset`	`number`	No	`0`	Number of presets to skip for pagination.

Response

200 OK

{
  presets: PresetResponse[];
  limit: number;
  offset: number;
}

Field	Type	Description
`presets`	`PresetResponse[]`	Array of preset objects. See Create Preset for the full `PresetResponse` schema.
`limit`	`number`	The limit value used for this request.
`offset`	`number`	The offset value used for this request.

Error responses

Status	Error	Description
`401`	`UNAUTHORIZED`	Missing or invalid API key.
`429`	`RATE_LIMITED`	Too many requests. Retry after the period indicated in the `Retry-After` header.

Examples

curl

curl "https://renderio.dev/api/v1/presets?limit=10&offset=0" \
  -H "X-API-KEY: ffsk_your_api_key_here"

JavaScript (fetch)

const params = new URLSearchParams({ limit: "10", offset: "0" });

const response = await fetch(
  `https://renderio.dev/api/v1/presets?${params}`,
  {
    headers: {
      "X-API-KEY": "ffsk_your_api_key_here",
    },
  },
);

const { presets, limit, offset } = await response.json();
console.log(`Found ${presets.length} presets (offset: ${offset})`);

Python (requests)

import requests

response = requests.get(
    "https://renderio.dev/api/v1/presets",
    headers={"X-API-KEY": "ffsk_your_api_key_here"},
    params={"limit": 10, "offset": 0},
)

data = response.json()
for preset in data["presets"]:
    print(f"{preset['name']} (system: {preset['is_system']})")

List Presets

On this page