Skip to main content
GET
Get a preset

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Path Parameters

id
string
required

Preset id (preset_<12hex>).

Example:

"preset_5f4dcc3b5aa7"

Response

The preset

id
string
required

Canonical preset reference (preset_<12hex>).

Example:

"preset_5f4dcc3b5aa7"

kind
string
required

Preset layer. Currently always provider_value.

Example:

"provider_value"

type
string
required

Which parameter the preset fills (for example voice, style).

Example:

"voice"

namespace
string
required

Whose id system minted the value (for example elevenlabs, higgsfield, fal).

Example:

"elevenlabs"

name
string
required
Example:

"Brian"

description
string | null
required
preview_url
string | null
required

Sample audio or image for the preset.

metadata
object
required

Filterable attributes. Keys vary by type; values are strings or arrays of strings.

status
enum<string>
required
Available options:
active,
deprecated
tools
object
required

Ready-to-merge request fragment per tool, keyed by tool name. A fragment with a broken mapping is returned as { "_error": "<message>" }.

Example: