Skip to main content

Overview

Presets endpoints

Available Operations

List

Lists all presets for the authenticated user, ordered by most recently updated first.

Example Usage

Parameters

Response

*operations.ListPresetsResponse, error

Errors

Delete

Archives a preset: it no longer resolves for inference and is hidden from get and list. The preset and its versions are kept, so the slug stays taken; restore it with POST /presets/{slug}/restore. Deleting an already-archived preset succeeds again. A disabled preset returns 409. Requires a read-write management key; inference API keys are rejected. workspace_id may be sent as a query parameter or a JSON body field.

Example Usage

Parameters

Response

*components.GetPresetResponse, error

Errors

Get

Retrieves a preset by its slug with its currently designated version inline.

Example Usage

Parameters

Response

*components.GetPresetResponse, error

Errors

CreatePresetsChatCompletions

Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored. Requires a read-write management key; inference API keys are rejected.

Example Usage

Parameters

Response

*components.CreatePresetFromInferenceResponse, error

Errors

CreatePresetsMessages

Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored. Requires a read-write management key; inference API keys are rejected.

Example Usage

Parameters

Response

*components.CreatePresetFromInferenceResponse, error

Errors

CreatePresetsResponses

Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored. Requires a read-write management key; inference API keys are rejected.

Example Usage

Parameters

Response

*components.CreatePresetFromInferenceResponse, error

Errors

Restore

Re-activates an archived preset so it resolves for inference again. No version is created and the designated version is unchanged. Restoring an active preset returns it unchanged. A disabled preset returns 409. Requires a read-write management key; inference API keys are rejected. workspace_id may be sent as a query parameter or a JSON body field.

Example Usage

Parameters

Response

*components.GetPresetResponse, error

Errors

ListVersions

Lists all versions of a preset, ordered by version number ascending (oldest first).

Example Usage

Parameters

Response

*operations.ListPresetVersionsResponse, error

Errors

GetVersion

Retrieves a specific version of a preset by its slug and version number.

Example Usage

Parameters

Response

*components.GetPresetVersionResponse, error

Errors