Sign in

v18

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

Update Prompt Version Draft

Updates the draft template code of a specific version. Only versions currently in the 'draft' status may be modified.

put/v1/prompts/{id}/versions/{version}

Path parameters

idstring uuid required

Unique prompt UUID.

versionstring required

Version sequence number (integer) or version tag (string) to update.

Request body

templatestring
modelstring nullable

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

model_paramsobject nullable

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

Example request

{
  "template": "Hello, {{.name}}! Count is {{.count}}.",
  "model": "openai/gpt-4.1-mini",
  "model_params": {
    "temperature": 0.2
  }
}

Response

Version updated 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
      }
    }
  }
}