---
title: "POST /sites/{site_id}/builds"
method: POST
path: "/sites/{site_id}/builds"
tags: ["build"]
---

# POST /sites/{site_id}/builds

`POST /sites/{site_id}/builds`

Runs a build for a site. The build will be scheduled to run at the first opportunity, but it might not start immediately if insufficient account build capacity is available.

Files for build can be uploaded as a zipped site using one of these methods:
1. Set Content-Type to 'application/zip' and send the zip file as the raw request body
2. Set Content-Type to 'multipart/form-data' and include the zip file in the 'zip' field

## Query parameters

- `branch` string
- `clear_cache` boolean
- `image` string
- `template_id` string
- `title` string

## Response `200`

OK

- Build
  - `id` string
  - `deploy_id` string
  - `sha` string
  - `done` boolean
  - `error` string
  - `created_at` string, dateTime

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity
- `default` — error

---

[API](https://skmtc.net/netlify/apis/netlify-s-api-documentation.md) · [All operations](https://skmtc.net/netlify/apis/netlify-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netlify/netlify-s-api-documentation/revisions/71540d1b5d9d/schema)