v24

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-02251756.0 KB

Create build

Create a build, on top of a project branch, against a given input revision.

The project branch will be modified so that its latest set of config files points to the one specified by the input revision.

post/v0/builds

Request body

projectstring required

Project name

branchstring

The project branch to use for the build. If not specified, the branch is inferred from the revision, and will 400 when that is not possible.

targetsTarget[]

Optional list of SDK targets to build. If not specified, all configured targets will be built.

commit_messagestring

Optional commit message to use when creating a new commit.

allow_emptyboolean

Whether to allow empty commits (no changes). Defaults to false.

enable_ai_commit_messageboolean

Whether to generate AI-powered commit messages for the build. Cannot be combined with commit_message or target_commit_messages.

Response

success

object'build' required
idstring required

Build ID

updated_atstring date-time required
created_atstring date-time required
projectstring required
orgstring required
config_commitstring required