---
title: "Start Precompute Build"
method: POST
path: "/api/v1/admin/admin-utils/precompute/build"
tags: ["Admin APIs", "admin-utils"]
---

# Start Precompute Build

`POST /api/v1/admin/admin-utils/precompute/build`

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

Returns the queued job; the scan runs for minutes on power-api and is
polled through ``/precompute/build/{job_id}``.

## Request body

- PrecomputeBuildRequest — Which payloads to build, and how. ``force`` and ``resume`` are not two settings of one dial. ``force`` decides whether a payload already published at this version is scanned again; ``resume`` decides whether one an earlier build staged and never published is taken live as it stands, which is the several minutes of Neo4j a build that died partway through does not need to spend twice.
  - `artifacts` string[], nullable
  - `force` boolean
  - `dry_run` boolean
  - `resume` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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