Presets

List presets

Changed on

Browse the preset catalogue: reusable parameter values you cannot guess (voice ids, style ids). Auth is optional; a Bearer token additionally includes the account's private presets. Any query parameter other than type, namespace, tool, q and limit is treated as a metadata filter (for example ?gender=male&tone=deep); discover the available axes with GET /presets/filters. List items carry no tools fragments; fetch GET /presets/{id} for those.

get/presets

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/presets
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

typestring
Example:voice

Filter by parameter type (for example voice, style).

namespacestring
Example:elevenlabs

Filter by the id system that minted the value (for example elevenlabs, higgsfield, fal).

toolstring
Example:speech

Only presets that can be delivered into this tool.

qstring

Free-text search over name and description.

limitinteger

Max results. Values above 200 are clamped; invalid values fall back to 50.

Response

Matching presets

countinteger required

Total number of matches, before limit is applied.

Example response

{
  "data": [
    {
      "id": "preset_5f4dcc3b5aa7",
      "kind": "provider_value",
      "type": "voice",
      "namespace": "elevenlabs",
      "name": "Brian"
    }
  ]
}

Changes