> ## 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 deployment

> List and delete deployments

## Overview

Manage your deployments from the command line. List all deployments in your organization or delete deployments you no longer need.

## Commands

### List Deployments

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

Output:

```
  Deployments (2)

   my-research-crew
   ID:        dep_abc123def456
   Framework: crewai
   Production: v3 (running)
   Created:   1/15/2025, 10:30:00 AM

   my-writer-crew
   ID:        dep_xyz789ghi012
   Framework: crewai
   Production: v1 (running)
   Staging:    v2 (building)
   Created:   1/20/2025, 2:15:00 PM
```

### Delete a Deployment

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

This soft-deletes the deployment and all its versions. Existing in-flight runs will complete normally, but no new runs can be created.

<Warning>Deletion cannot be undone. All versions associated with the deployment will also be deleted.</Warning>

### Options

| Option         | Description                                    |
| -------------- | ---------------------------------------------- |
| `--name`, `-n` | Deployment name (for multi-deployment configs) |
| `--force`      | Skip confirmation prompt                       |

### Resolving the Deployment

If no deployment ID is provided, it is resolved from `crewship.toml` in the current directory:

```bash theme={null}
# Uses deployment ID from crewship.toml
crewship deployment delete

# Specify a deployment in a multi-deployment config
crewship deployment delete --name research-agent
```

## Examples

### List all deployments

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

### Delete by ID

```bash theme={null}
crewship deployment delete dep_abc123def456
```

### Delete with auto-resolve from config

```bash theme={null}
# In a directory with crewship.toml
crewship deployment delete

# Skip confirmation
crewship deployment delete --force
```

### Delete a named deployment

```bash theme={null}
crewship deployment delete --name research-agent --force
```

## Related

<CardGroup cols={2}>
  <Card title="Versions" icon="code-branch" href="/cli/version">
    Manage versions
  </Card>

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