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

# deploys

> CLI reference: floo deploys - view and manage deploy history

<Note>
  `floo deploys` is for viewing and managing deploy history. To trigger a deploy, push to GitHub or use [`floo redeploy`](/docs/cli/redeploy). To validate your config before pushing, use [`floo preflight`](/docs/cli/preflight).
</Note>

## How deploys are triggered

Deploys are config-as-code and git-driven — there is no `floo deploy` step in the everyday flow.

| Trigger                                | Result                                                             |
| -------------------------------------- | ------------------------------------------------------------------ |
| `git push` to your default branch      | Builds and deploys to the **dev** environment automatically.       |
| Cut a GitHub release on your repo      | Promotes that build to **production**.                             |
| `floo redeploy --app <name>`           | Re-runs the same image (e.g. after an env-var change), no rebuild. |
| `floo redeploy --rebuild --app <name>` | Forces a new build from the latest commit.                         |

After `floo apps github connect <owner/repo>`, you almost never need to run a deploy command directly — push, and the build starts. Watch progress with `floo deploys watch --app <name>` or in the dashboard.

## Subcommands

### `floo deploys list`

List compact deploy history for an app, newest first. Build logs are not included; use `floo deploys logs` for a specific deploy.

```bash theme={null}
floo deploys list --app my-app
```

| Flag        | Description      |
| ----------- | ---------------- |
| `--app APP` | App name or UUID |

### `floo deploys logs [DEPLOY_ID]`

Show build logs for a deploy. If `DEPLOY_ID` is omitted, shows logs for the latest deploy.

```bash theme={null}
floo deploys logs abc123 --app my-app
floo deploys logs abc123 --app my-app --follow
```

| Flag        | Description                                 |
| ----------- | ------------------------------------------- |
| `--app APP` | App name or UUID                            |
| `--follow`  | Stream logs in real-time for active deploys |

### `floo deploys watch`

Stream deploy progress in real-time. Waits for the deploy to finish and shows build logs as they arrive.

```bash theme={null}
floo deploys watch --app my-app
floo deploys watch --app my-app --commit abc1234
```

| Flag           | Description                                            |
| -------------- | ------------------------------------------------------ |
| `--app APP`    | App name or UUID                                       |
| `--commit SHA` | Match a deploy by commit SHA prefix (waits up to 120s) |

### `floo deploys status`

Print a compact, agent-safe deploy status summary. Emits the latest deploy's id, commit, derived phase booleans (`image_built` / `service_ready` / `host_bound`), the gateway URL, and a recommended next command — without dumping build logs, Cloud Run audit payloads, or env-var values. Built for agents and scripts that need to know "what state is the deploy in?" without risking secret exfiltration through verbose output.

```bash theme={null}
floo deploys status --app my-app
floo deploys status --app my-app --id e5f6g7h8 --json
```

| Flag        | Description                                          |
| ----------- | ---------------------------------------------------- |
| `--app APP` | App name or UUID                                     |
| `--id ID`   | Deploy ID. Defaults to the latest deploy for the app |
| `--json`    | Machine-readable output for agents                   |

### `floo deploys rollback APP DEPLOY_ID`

Rollback to a previous deploy.

```bash theme={null}
floo deploys rollback my-app abc123
floo deploys rollback my-app abc123 --force --json
```

| Flag      | Description              |
| --------- | ------------------------ |
| `--force` | Skip confirmation prompt |

## JSON output

```json theme={null}
{
  "success": true,
  "data": {
    "deploys": [
      {
        "id": "e5f6g7h8-...",
        "status": "live",
        "url": "https://my-app.on.getfloo.com",
        "created_at": "2026-04-06T12:00:00Z"
      }
    ]
  }
}
```

## Errors

| Code                | Meaning                                             |
| ------------------- | --------------------------------------------------- |
| `NOT_AUTHENTICATED` | Run `floo auth login` first                         |
| `APP_NOT_FOUND`     | The `--app` value doesn't match any existing app    |
| `DEPLOY_NOT_FOUND`  | The deploy ID doesn't match any deploy for this app |