v1

latestOpenAPI 3.0.02026-07-26242779.3 KB

Get upload URL for build context

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.

post/builds/upload-url

Request body

regionstring required

Target region for the build. Must be a region where cloud builds are enabled.

Example request

{
  "region": "us-west"
}

Response

Upload URL generated successfully

uploadIdstring uuid

Unique identifier for this upload. Use this when creating the build.

uploadUrlstring uri

Pre-signed URL to upload your context archive. Use HTTP POST with form-data.

uploadFieldsobject

Form fields that must be included when uploading to the pre-signed URL.

expiresAtstring date-time

When the upload URL expires. Upload must complete before this time.

Example response

{
  "uploadId": "550e8400-e29b-41d4-a716-446655440000",
  "uploadUrl": "https://daily-co-pcc-build-context.s3.amazonaws.com",
  "uploadFields": {
    "key": "org-123/550e8400-e29b-41d4-a716-446655440000.tar.gz",
    "bucket": "daily-co-pcc-build-context-qa-us-west-2",
    "Content-Type": "application/gzip",
    "Policy": "eyJleHBpcmF0aW9uIjoi...",
    "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
    "X-Amz-Credential": "ASIA.../us-west-2/s3/aws4_request",
    "X-Amz-Date": "20260220T120000Z",
    "X-Amz-Security-Token": "FwoGZXIvYXdzE...",
    "X-Amz-Signature": "abc123..."
  },
  "expiresAt": "2026-02-20T12:15:00.000Z"
}