Delete Preset

DELETE /api/v1/presets/:presetId

Delete a preset that belongs to your account. System presets cannot be deleted.

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

Path parameters

Parameter	Type	Required	Description
`presetId`	`string`	Yes	The unique identifier of the preset to delete.

Response

200 OK

{
  deleted: true;
  preset_id: string;
}

Field	Type	Description
`deleted`	`boolean`	Always `true` on success.
`preset_id`	`string`	The ID of the deleted preset.

Error responses

Status	Error	Description
`401`	`UNAUTHORIZED`	Missing or invalid API key.
`404`	`NOT_FOUND`	Preset does not exist, does not belong to your account, or is a system preset.
`429`	`RATE_LIMITED`	Too many requests. Retry after the period indicated in the `Retry-After` header.

Examples

curl

curl -X DELETE https://renderio.dev/api/v1/presets/prs_abc123 \
  -H "X-API-KEY: ffsk_your_api_key_here"

JavaScript (fetch)

const presetId = "prs_abc123";

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

const result = await response.json();
console.log(`Deleted preset: ${result.preset_id}`);

Python (requests)

import requests

preset_id = "prs_abc123"

response = requests.delete(
    f"https://renderio.dev/api/v1/presets/{preset_id}",
    headers={"X-API-KEY": "ffsk_your_api_key_here"},
)

result = response.json()
print(f"Deleted preset: {result['preset_id']}")

Delete Preset

On this page