Prompt Versions

Create a Prompt Version

Changed on

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

post/v1/prompts/{id}/versions

Request

  • Base URL: http://localhost:3000
  • URL: http://localhost:3000/v1/prompts/{id}/versions
  • Auth: HTTP bearer

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

Changes

  • bed7a47c6f25Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • e500bc0895c5Revision changes
    • info

      the endpoint scheme security ApiKeyAuth was removed from the API