Sign in

v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2112360218.7 KB
Prompt Versions

Create a Prompt Version

Creates a new version of the prompt template in 'draft' state.

post/v1/prompts/{id}/versions

Path parameters

idstring uuid required

Unique prompt UUID.

Request body

templatestring required
modelstring

Optional provider/model identifier intended to execute this prompt version.

model_paramsobject

Optional provider-specific model parameters. Nested values are supported.

Example request

{
  "template": "Hello, {{.name}}!",
  "model": "anthropic/claude-opus-4-6",
  "model_params": {
    "temperature": 0.7,
    "max_tokens": 1024
  }
}

Response

Version created successfully

Example response

{
  "version": {
    "template": "Hello {{.name}}!",
    "model": "anthropic/claude-opus-4-6",
    "model_params": {
      "temperature": 0.7,
      "max_tokens": 1024,
      "thinking": {
        "type": "enabled",
        "budget_tokens": 512
      }
    }
  }
}