---
title: "List builds"
method: GET
path: "/builds"
---

# List builds

`GET /builds`

List all builds for your organization with optional filters.

## Query parameters

- `status` 'pending' | 'building' | 'success' | 'failed' | 'timeout'
- `region` string
- `contextHash` string
- `limit` integer
- `offset` integer

## Response `200`

List of builds

- ListBuildsResponse
  - `builds` Build[] — Array of build objects.
    - `id` string, uuid — Unique identifier for the build.
    - `organizationId` string — Organization that owns this build.
    - `status` 'pending' | 'building' | 'success' | 'failed' | 'timeout' — Current status of the build.
    - `region` string — Region where the build ran.
    - `contextHash` string — Hash of the build context.
    - `dockerfilePath` string — Path to the Dockerfile used for this build.
    - `imageUri` string — URI of the built image. Use this value when deploying an agent. Only present when status is 'success'.
    - `logsUrl` string, uri — URL to view build logs in the cloud console.
    - `errorMessage` string — Detailed error message if the build failed. Includes information from the build phases to help diagnose issues.
    - `contextSizeBytes` integer — Size of the uploaded context in bytes.
    - `imageSizeBytes` integer — Size of the built Docker image in bytes. Only present for successful builds.
    - `buildDurationSeconds` integer — Total build duration in seconds. Only present when build is complete.
    - `startedAt` string, date-time — When the build started executing.
    - `completedAt` string, date-time — When the build completed (success, failed, or timeout).
    - `createdAt` string, date-time — When the build record was created.
    - `updatedAt` string, date-time — When the build record was last updated.
  - `total` integer — Total number of builds matching the filters.
  - `limit` integer — Maximum number of builds returned.
  - `offset` integer — Number of builds skipped.

---

[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)