---
title: "List generation presets"
method: GET
path: "/v2/generation_presets"
tags: ["Generation Presets"]
---

# List generation presets

`GET /v2/generation_presets`

Lists the generation presets used for [query](/docs/rest-api/queries) requests. The platform creates and maintains predefined generation presets. A generation preset groups several properties that configure generation for a request. This includes the `prompt_template`, the Large Language Model (LLM), and other generation settings like `max_tokens` and `temperature`. Each preset includes a complete Velocity template for the prompt. Presets are typically associated with a single LLM.

Specify a generation preset in query or chat requests with the `generation_preset_name` field.

## Generation presets object

The `generation_presets` object contains the `name`, `description`, `llm_name`, `prompt_template`, and other fields that make up the preset.

If your account has access to a preset, `enabled` is set to `true`. A preset can also be set as a `default`.

### Example generation presets response

```json
{
  "generation_presets": [
    {
      "name": "vectara-summary-ext-24-05-med-omni",
      "description": "Generate summary with controllable citations, Uses GPT-4o with 2,048 max tokens",
      "llm_name": "gpt-4o",
      "prompt_template": "[\n    {\"role\": \"system\", \"content\": \"Follow these detailed step-by-step",
      "max_used_search_results": 25,
      "max_tokens": 2048,
      "temperature": 0,
      "frequency_penalty": 0,
      "presence_penalty": 0,
      "enabled": true,
      "default": false
    }
  ]
}
```

## Query parameters

- `llm_name` string
- `filter` string
- `limit` integer
- `page_key` string

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

List of Generation Presets.

- ListGenerationPresetsResponse — Response containing a list of generation presets for configuring RAG behavior.
  - `generation_presets` GenerationPreset[] — List of generation presets.
    - `id` string — The ID of the generation preset.
    - `name` string, required — The name of the generation preset. Use this name to configure generation.
    - `description` string — Description of the generation preset.
    - `llm_name` string — The name of the model that this preset is used with. The `GET /v2/llms` endpoint lists the available names.
    - `prompt_template` string — The preset template that renders the prompt sent to generation.
    - `max_used_search_results` integer — The preset maximum number of search results available to the prompt.
    - `max_tokens` integer — The preset maximum number of tokens that generation returns.
    - `temperature` number, float — The sampling temperature to use. Higher values make the output more random, while lower values make it more focused and deterministic.
    - `frequency_penalty` number, float — Higher values penalize new tokens based on their existing frequency in the generation so far, decreasing the model's likelihood to repeat the same line verbatim.
    - `presence_penalty` number, float — Higher values penalize new tokens based on whether they appear in the generation so far, increasing the model's likelihood to talk about new topics.
    - `additional_model_params` object — Additional model parameters beyond the standard fields above.
    - `enabled` boolean — Indicates whether the generation preset is enabled.
    - `default` boolean — Indicates whether this is the default generation preset for the LLM.
    - `ownership` 'platform' | 'customer' — Indicates whether the generation preset is provided by the platform or created by the customer. Platform presets are pre-configured and cannot be modified or deleted. Customer presets are created and managed by the customer.
  - `metadata` ListMetadata — The standard metadata in the response of a list operation.
    - `page_key` string — The page key for the next page of results. Pass it as a query parameter to request the next page.

## Other responses

- `403` — Permissions do not allow listing generation presets.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/e85040b266cc/schema)