> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipecat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# build

> Manage cloud builds

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`](/api-reference/cli/cloud/deploy) without specifying an image. These commands help you monitor and manage those builds.

## logs

View logs for a cloud build.

**Usage:**

```shell theme={null}
pipecat cloud build logs [OPTIONS] BUILD_ID
```

**Arguments:**

<ParamField path="build_id" type="string" required>
  The ID of the build to get logs for. You can find build IDs using `pipecat cloud build list`.
</ParamField>

**Options:**

<ParamField path="--limit / -n" type="number" default="500">
  Number of log lines to retrieve. Maximum is 10000.
</ParamField>

<ParamField path="--organization / -o" type="string">
  Organization to use. If not provided, uses the current organization from your configuration.
</ParamField>

## status

Get the current status of a cloud build.

**Usage:**

```shell theme={null}
pipecat cloud build status [OPTIONS] BUILD_ID
```

**Arguments:**

<ParamField path="build_id" type="string" required>
  The ID of the build to check.
</ParamField>

**Options:**

<ParamField path="--organization / -o" type="string">
  Organization to use. If not provided, uses the current organization from your configuration.
</ParamField>

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:**

```shell theme={null}
pipecat cloud build list [OPTIONS]
```

**Options:**

<ParamField path="--limit / -n" type="number" default="10">
  Number of builds to list. Maximum is 100.
</ParamField>

<ParamField path="--status / -s" type="string">
  Filter by build status. Valid values: `pending`, `building`, `success`, `failed`, `timeout`.
</ParamField>

<ParamField path="--region / -r" type="string">
  Filter by region.
</ParamField>

<ParamField path="--organization / -o" type="string">
  Organization to use. If not provided, uses the current organization from your configuration.
</ParamField>

## Examples

**List all recent builds:**

```shell theme={null}
pipecat cloud build list
```

**List only failed builds:**

```shell theme={null}
pipecat cloud build list --status failed
```

**View logs for a specific build:**

```shell theme={null}
pipecat cloud build logs abc12345-6789-0abc-def0-123456789abc
```

**Check status of a build:**

```shell theme={null}
pipecat cloud build status abc12345-6789-0abc-def0-123456789abc
```