---
title: "Get upload URL for build context"
method: POST
path: "/builds/upload-url"
---

# Get upload URL for build context

`POST /builds/upload-url`

Generate a pre-signed URL for uploading your Docker build context (tar.gz archive) to Pipecat Cloud storage. The returned URL expires after 15 minutes.

## Request body

- UploadUrlRequest
  - `region` string, required — Target region for the build. Must be a region where cloud builds are enabled.

## Response `200`

Upload URL generated successfully

- UploadUrlResponse
  - `uploadId` string, uuid — Unique identifier for this upload. Use this when creating the build.
  - `uploadUrl` string, uri — Pre-signed URL to upload your context archive. Use HTTP POST with form-data.
  - `uploadFields` object — Form fields that must be included when uploading to the pre-signed URL.
  - `expiresAt` string, date-time — When the upload URL expires. Upload must complete before this time.

## Other responses

- `400` — Invalid request (e.g., cloud build not enabled for region)

---

[API](https://skmtc.dev/pipecat/apis/pipecat-cloud.md) · [All operations](https://skmtc.dev/pipecat/apis/pipecat-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipecat/pipecat-cloud/revisions/acd0f7dfe734/schema)