Promote Revision
promoteRevisionPromote a draft or historic revision to the live version. Before calling, confirm with the user which agent and revision will go live and that triggers and new runs will use it. The live revision is the one used by triggers and new runs. Fails if the revision is already live, if a draft revision still has an active builder run, or with 409 if the agent's automation runs as the team and the revision sends cases to a queue that is not in a team automation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"build_id": "<build_id>"
},
"name": "promoteRevision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| build_id | Yes | The build's unique identifier | |
| revision_name | No | Optional display name to set on the promoted revision. | |
| revision_description | No | Optional description for the promoted revision. Pass null to clear an existing description. |