builds_start_by_ref_id
Start an Xcode Cloud build directly using a Git reference ID, bypassing the need to resolve branch or tag names.
Instructions
[XcodeCloud/Builds] Start a new build using a Git reference ID directly.
Use this when you already have the Git reference UUID to skip resolution.
For branch/tag names, use builds_start instead.
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": {
"workflow_id": "<workflow_id>"
},
"name": "builds_start_by_ref_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflow_id | Yes | ||
| source_ref_id | No | ||
| pull_request_number | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||