v1

latestOpenAPI 3.0.02026-07-26242779.3 KB

List builds

List all builds for your organization with optional filters.

get/builds

Query parameters

status'pending' | 'building' | 'success' | 'failed' | 'timeout'

Filter by build status.

regionstring

Filter by region.

contextHashstring

Filter by context hash.

limitinteger

Maximum number of builds to return.

offsetinteger

Number of builds to skip for pagination.

Response

List of builds

totalinteger

Total number of builds matching the filters.

limitinteger

Maximum number of builds returned.

offsetinteger

Number of builds skipped.

Example response

{
  "builds": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "organizationId": "org_abc123",
      "status": "success",
      "region": "us-west",
      "contextHash": "a1b2c3d4e5f6a7b8",
      "dockerfilePath": "Dockerfile",
      "imageUri": "123456789.dkr.ecr.us-west-2.amazonaws.com/pipecat-cloud/org_abc123:a1b2c3d4e5f6a7b8",
      "logsUrl": "https://console.aws.amazon.com/codebuild/...",
      "errorMessage": "Docker build failed: COPY failed - file not found: requirements.txt",
      "contextSizeBytes": 10485760,
      "imageSizeBytes": 524288000,
      "buildDurationSeconds": 120,
      "startedAt": "2026-02-20T12:00:00.000Z",
      "completedAt": "2026-02-20T12:02:00.000Z",
      "createdAt": "2026-02-20T12:00:00.000Z",
      "updatedAt": "2026-02-20T12:02:00.000Z"
    }
  ],
  "total": 42,
  "limit": 20
}