# Codebase Builds API

**Canonical:** https://apis.io/apis/codebase-design/codebase-design-builds-api/  
**Provider:** Codebase — https://apis.io/providers/codebase-design/  
**Base URL:** https://dev.codebase.design  
**Documentation:** https://codebase.design/docs/api

Codebase Builds API is one of 16 APIs that [Codebase](https://apis.io/providers/codebase-design/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Builds. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and 1 JSON Schema.

The Builds API from Codebase — 7 operation(s) for builds.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/builds` | Trigger a build |
| GET | `/api/v1/builds/{sessionId}/status` | Get build status |
| GET | `/api/v1/builds/{sessionId}/events` | Stream build events |
| POST | `/api/v1/builds/{sessionId}/cancel` | Cancel a running build |
| POST | `/api/v1/builds/{sessionId}/retry` | Retry a build turn |
| POST | `/api/v1/builds/{sessionId}/resume` | Resume or attach to a build |
| POST | `/api/v1/builds/{sessionId}/preview` | Start or reuse a build's live preview |
| DELETE | `/api/v1/builds/{sessionId}/preview` | Release a build preview |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/codebase-design/openapi/codebase-design-builds-api-openapi.yml
- **APIReference** — https://codebase.design/api-docs/
- **Documentation** — https://codebase.design/docs/api
- **JSONSchema** — https://artifacts.apis.io/codebase-design/json-schema/codebase-design-build-handoff-schema.json

## Other Codebase APIs (12)

- [Codebase MCP Server](https://apis.io/apis/codebase-design/codebase-design-mcp/)
- [Codebase Account API](https://apis.io/apis/codebase-design/codebase-design-account-api/)
- [Codebase Admin API](https://apis.io/apis/codebase-design/codebase-design-admin-api/)
- [Codebase API Keys API](https://apis.io/apis/codebase-design/codebase-design-api-keys-api/)
- [Codebase Billing API](https://apis.io/apis/codebase-design/codebase-design-billing-api/)
- [Codebase Community API](https://apis.io/apis/codebase-design/codebase-design-community-api/)
- [Codebase Credits API](https://apis.io/apis/codebase-design/codebase-design-credits-api/)
- [Codebase Deploys API](https://apis.io/apis/codebase-design/codebase-design-deploys-api/)
- [Codebase Gallery API](https://apis.io/apis/codebase-design/codebase-design-gallery-api/)
- [Codebase Health API](https://apis.io/apis/codebase-design/codebase-design-health-api/)
- [Codebase Inference API](https://apis.io/apis/codebase-design/codebase-design-inference-api/)
- [Codebase Platform API](https://apis.io/apis/codebase-design/codebase-design-platform-api/)

## Tags

Builds

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codebase-design/codebase-design-builds-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codebase-design/.
