Skip to main content
The build command provides tools for managing cloud builds on Pipecat Cloud. You can view build logs, check build status, and list recent builds. Cloud builds are typically triggered automatically when you run pipecat cloud deploy without specifying an image. These commands help you monitor and manage those builds.

​
logs

View logs for a cloud build. Usage: 
pipecat cloud build logs [OPTIONS] BUILD_ID
Arguments:
​
build_id
string
required
The ID of the build to get logs for. You can find build IDs using pipecat cloud build list.
Options:
​
--limit / -n
number
default:"500"
Number of log lines to retrieve. Maximum is 10000.
​
--organization / -o
string
Organization to use. If not provided, uses the current organization from your configuration.

​
status

Get the current status of a cloud build. Usage: 
pipecat cloud build status [OPTIONS] BUILD_ID
Arguments:
​
build_id
string
required
The ID of the build to check.
Options:
​
--organization / -o
string
Organization to use. If not provided, uses the current organization from your configuration.
The status command displays detailed build information including:
  • Current status (pending, building, success, failed, timeout)
  • Region, context hash, and Dockerfile path
  • Timestamps for creation, start, and completion
  • Build duration and context/image sizes
  • Error messages (if the build failed)

​
list

List recent cloud builds. Usage: 
pipecat cloud build list [OPTIONS]
Options:
​
--limit / -n
number
default:"10"
Number of builds to list. Maximum is 100.
​
--status / -s
string
Filter by build status. Valid values: pending, building, success, failed, timeout.
​
--region / -r
string
Filter by region.
​
--organization / -o
string
Organization to use. If not provided, uses the current organization from your configuration.

​
Examples

List all recent builds: 
pipecat cloud build list
List only failed builds: 
pipecat cloud build list --status failed
View logs for a specific build: 
pipecat cloud build logs abc12345-6789-0abc-def0-123456789abc
Check status of a build: 
pipecat cloud build status abc12345-6789-0abc-def0-123456789abc