---
title: "Create build"
method: POST
path: "/v0/builds"
---

# Create build

`POST /v0/builds`

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.

## Request body

- object
  - `project` string, required — Project name
  - `branch` string — 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.
  - `revision` union, required — Specifies what to build: a branch name, commit SHA, merge command ("base..head"), or file contents.
    - string — A branch name, commit SHA, or merge command in the format "base..head"
    - object — File contents to commit directly
  - `targets` Target[] — Optional list of SDK targets to build. If not specified, all configured targets will be built.
  - `commit_message` string — Optional commit message to use when creating a new commit.
  - `target_commit_messages` object — Optional commit messages to use for each SDK when making a new commit. SDKs not represented in this object will fallback to the optional `commit_message` parameter, or will fallback further to the default commit message.
    - `node` string
    - `typescript` string
    - `python` string
    - `go` string
    - `java` string
    - `kotlin` string
    - `ruby` string
    - `terraform` string
    - `cli` string
    - `php` string
    - `csharp` string
    - `sql` string
    - `openapi` string
  - `allow_empty` boolean — Whether to allow empty commits (no changes). Defaults to false.
  - `enable_ai_commit_message` boolean — Whether to generate AI-powered commit messages for the build. Cannot be combined with `commit_message` or `target_commit_messages`.

## Response `200`

success

- Build
  - `object` 'build', required
  - `id` string, required — Build ID
  - `updated_at` string, date-time, required
  - `created_at` string, date-time, required
  - `project` string, required
  - `org` string, required
  - `config_commit` string, required
  - `documented_spec` union, required
    - object
      - `type` 'content', required
      - `content` string, required
    - object
      - `type` 'url', required
      - `url` string, required
      - `expires` string, date-time, required
  - `targets` object, required
    - `node` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `typescript` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `python` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `go` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `java` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `kotlin` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `ruby` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `terraform` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `cli` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `php` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `csharp` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `sql` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required
    - `openapi` BuildTarget
      - `object` 'build_target', required
      - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
      - `commit` union, required
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
        - object
          - `status` 'in_progress', required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
            - `merge_conflict_pr` object, nullable, required
              - …
            - `commit` Commit, required
              - …
            - `completed_at` string, date-time, required
          - `conclusion` 'error' | 'warning' | 'note' | 'success' | 'merge_conflict' | 'upstream_merge_conflict' | 'fatal' | 'payment_required' | 'cancelled' | 'timed_out' | 'noop' | 'version_bump', required
          - `merge_conflict_pr` object, nullable, required
            - `number` number, required
            - `repo` object, required
              - …
          - `commit` Commit, required
            - `sha` string, required
            - `repo` object, required
              - …
            - `tree_oid` string, nullable, required
            - `stats` object, nullable, required
              - …
          - `completed_at` string, date-time, required
      - `lint` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `test` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `build` union
        - object
          - `status` 'not_started', required
        - object
          - `status` 'queued', required
          - `url` string, nullable, required
        - object
          - `status` 'in_progress', required
          - `url` string, nullable, required
        - object
          - `status` 'completed', required
          - `completed` object, required — deprecated
            - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
            - `url` string, nullable, required
          - `conclusion` 'success' | 'failure' | 'skipped' | 'cancelled' | 'action_required' | 'neutral' | 'timed_out', required
          - `url` string, nullable, required
      - `install_url` string, nullable, required

## Changes

- **2026-03-02** `1d73a351f557` — 39 breaking, 39 info
  - added `subschema #2, subschema #3` to the `targets/cli/build` response property `oneOf` list for the response status `200`
  - added `subschema #2, subschema #3` to the `targets/cli/lint` response property `oneOf` list for the response status `200`
  - added `subschema #2, subschema #3` to the `targets/cli/test` response property `oneOf` list for the response status `200`
  - added `subschema #2, subschema #3` to the `targets/csharp/build` response property `oneOf` list for the response status `200`
  - …74 more
- **2026-02-23** `60fccc45e9e7` — 26 info
  - added the required property `targets/cli/commit/oneOf[subschema #4]/completed/completed_at` to the response with the `200` status
  - added the required property `targets/cli/commit/oneOf[subschema #4]/completed_at` to the response with the `200` status
  - added the required property `targets/csharp/commit/oneOf[subschema #4]/completed/completed_at` to the response with the `200` status
  - added the required property `targets/csharp/commit/oneOf[subschema #4]/completed_at` to the response with the `200` status
  - …22 more
- …earlier changes not shown

[Full history](https://skmtc.dev/stainless-api/apis/my-api/changes/v0/builds/post.md)

---

[API](https://skmtc.dev/stainless-api/apis/my-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/my-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stainless-api/my-api/revisions/1d73a351f557/schema)