Prompt Versions

Update Prompt Version Draft

Changed on

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}

Request

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

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

Changes

  • 4260a250ce25Revision changes
    • info

      the request property became nullable

    • info

      the request property became nullable

  • bed7a47c6f25Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status