v18

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

Attach/Set Version Tag

Attaches a unique string tag (e.g. 'prod') to the specified prompt version, replacing the tag on any other version of this prompt if it was already assigned.

post/v1/prompts/{id}/versions/{version}/tags

Path parameters

idstring uuid required

Unique prompt UUID.

versionstring required

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

Request body

tagstring required

Tag string (alphanumeric, dots, dashes, underscores).

Example request

{
  "tag": "prod"
}

Response

Tag attached successfully. Returns the updated version.

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