---
title: "Start Precompute Build"
method: POST
path: "/v2/precompute/build"
tags: ["Precompute Internal"]
---

# Start Precompute Build

`POST /v2/precompute/build`

Start a build, which publishes what it writes when it finishes.

Returns the queued job; poll ``/build/{id}`` for progress.

## Request body

- BuildRequest
  - `artifacts` string[], nullable — Artifact names to build; all of them when omitted.
  - `force` boolean — Rebuild even when the published payload already matches.
  - `dry_run` boolean — Scan and report sizes without staging anything.
  - `triggered_by` string, nullable — Operator identity, recorded on the job.

## Response `200`

Successful Response

- unknown

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/bd33ea42994c/schema)