codemagic_start_build
Trigger a new build for a specified app and workflow on a branch or git tag, returning the build ID for status polling.
Instructions
Trigger a new build for an app/workflow on a branch or tag.
Provide exactly one of branch or tag. Returns the new buildId, which you can poll with codemagic_get_build.
Args: app_id: The Codemagic application id. workflow_id: The workflow id from codemagic.yaml (e.g. "ios-release"). branch: Branch to build (e.g. "main"). Mutually exclusive with tag. tag: Git tag to build (e.g. "v1.2.0"). Mutually exclusive with branch.
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": {
"app_id": "<app_id>",
"workflow_id": "<workflow_id>"
},
"name": "codemagic_start_build"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_id | Yes | ||
| workflow_id | Yes | ||
| branch | No | ||
| tag | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |