---
title: "REST API reference"
description: "The OpenAPI reference for the public Build REST API under /api/build."
url: https://docs.spinrun.ai/api
markdown_url: https://docs.spinrun.ai/api.md
---

# REST API reference

One page per operation, generated from the OpenAPI document that `@spinrun/build-contract` builds from the same Zod schemas the routes validate with. The REST twin lives under `/api/build` with the same auth and documents as `/mcp/build`.

All routes take `Authorization: Bearer <token>`. Success is `{"data": …}`; failure is `{"error": "…"}`, plus `current` and `applied` on a `409`.

## Related [#related]

* [Build](https://docs.spinrun.ai/build.md)
* [Concurrency](https://docs.spinrun.ai/build/concurrency.md)