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

# crewship version

> List and delete versions for a deployment

## Overview

Manage versions for your deployments. List all versions to see their status, or delete versions you no longer need.

## Commands

### List Versions

```bash theme={null}
crewship version list [deployment-id]
```

If no deployment ID is provided, it is resolved from `crewship.toml`.

Output:

```
  Versions (3)

   v3 (production)
   ID:      ver_abc123def456
   Status:  running
   Created: 1/22/2025, 3:00:00 PM

   v2 (production)
   ID:      ver_xyz789ghi012
   Status:  stopped
   Created: 1/20/2025, 1:30:00 PM

   v1 (production)
   ID:      ver_mno345pqr678
   Status:  stopped
   Created: 1/15/2025, 10:45:00 AM
```

### Options for list

| Option          | Description                                      |
| --------------- | ------------------------------------------------ |
| `--name`, `-n`  | Deployment name (for multi-deployment configs)   |
| `--environment` | Filter by environment: `production` or `staging` |

### Delete a Version

```bash theme={null}
crewship version delete <version-id>
```

This soft-deletes the version. If the version was running, it will no longer receive new runs. Existing in-flight runs will complete normally.

<Warning>Deletion cannot be undone.</Warning>

### Options for delete

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

## Examples

### List versions for a deployment

```bash theme={null}
# By deployment ID
crewship version list dep_abc123def456

# From crewship.toml
crewship version list

# For a named deployment
crewship version list --name research-agent

# Filter by environment
crewship version list --environment production
```

### Delete a version

```bash theme={null}
crewship version delete ver_abc123def456

# Skip confirmation
crewship version delete ver_abc123def456 --force
```

## Related

<CardGroup cols={2}>
  <Card title="Deployments" icon="server" href="/cli/deployment">
    Manage deployments
  </Card>

  <Card title="Deploy" icon="rocket" href="/cli/deploy">
    Deploy your crew
  </Card>
</CardGroup>