v1
latestSwagger 2.0MIT2026-08-06120162320.1 KBbuilds
Trigger a new build/pipeline
Trigger a new build/pipeline. Specify an app slug and at least one parameter out of three: a git tag or git commit hash, a branch, or a workflow/pipeline ID. You can also set specific parameters for Pull Request builds/pipelines and define additional environment variables for your build/pipeline. Check out our detailed guide.
post/apps/{app-slug}/builds
Path parameters
app-slugstring required
App slug
Request body
Example request
{
"build_params": {
"environments": [
{
"mapped_to": "Deprecated. Please use key instead"
}
],
"machine_type_id": "g2-m1.4core",
"stack": "osx-xcode-16.0.x"
},
"hook_info": {
"type": "bitrise"
}
}Response
Created