Prompt Versions
Promote Prompt Version
Promotes a version of the prompt template along the lifecycle: draft -> stable -> live. Promoting from draft makes it stable (read-only). Promoting from stable makes it live. When promoting a version to live, any previous live version is demoted to stable.
post/v1/prompts/{id}/versions/{version}/promote
Path parameters
idstring uuid required
Unique prompt UUID.
versionstring required
Version sequence number (integer) or version tag (string) to promote.
Response
Version promoted 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
}
}
}
}