API ReferenceApiTemplatesIdVersionsVersionidPromote
Promote a version to active
Sets the version as active and retires the current active version.
Authorization
bearerAuth AuthorizationBearer <token>
API key passed as Bearer token in the Authorization header
In: header
Path Parameters
id*string
versionId*string
Response Body
application/json
curl -X POST "http://localhost:5667/api/templates/cuid2_abc123/versions/cuid2_abc123/promote"{
"data": {
"id": "cuid2_abc123",
"templateId": "cuid2_abc123",
"version": 1,
"content": "# Signal Triage: {{issue.title}}\n\nYou are triaging signal #{{issue.number}}.",
"changelog": "Initial version",
"authorType": "human",
"authorName": "system",
"status": "active",
"usageCount": 0,
"completionRate": null,
"avgDurationMs": null,
"reviewScore": null,
"createdAt": "2026-02-20T12:00:00.000Z"
}
}Empty
Empty