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

# deployment list

> List deployments for the current project

Lists all deployments for the current project, showing their ID, age, environment, status, whether the deployment is current, duration, and author.

## Usage

```bash theme={null}
alpic deployment list
```

Lists all deployments for the project linked to the current directory.

## Extended Usage

List deployments by project ID:

```bash theme={null}
alpic deployment list --project-id <projectId>
```

List deployments by project name:

```bash theme={null}
alpic deployment list --project-name <projectName>
```

Filter deployments by environment:

```bash theme={null}
alpic deployment list --environment-id <environmentId>
```

Filter by one or more statuses:

```bash theme={null}
alpic deployment list --status deployed --status failed
```

## Options

| Flag               | Description                                                                                                      | Default |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- | ------- |
| `--project-id`     | The ID of the project.                                                                                           | —       |
| `--project-name`   | The name of the project.                                                                                         | —       |
| `--environment-id` | Filter by environment ID.                                                                                        | —       |
| `--status`         | Filter by status. Accepted values: `deployed`, `ongoing`, `failed`, `canceled`. Can be specified multiple times. | —       |