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

# Deploy pipeline

> Deploys a pipeline to start processing data.

```
POST /api/v1/beam/{config_id}/deploy
```

Deploys the pipeline to start processing data. Creates Kafka topics, provisions credentials, and spins up workers.

Deployment is **idempotent** — call it again after updating a config to apply changes with zero downtime. Do not teardown before redeploying.

**Path parameters:**

| Parameter   | Description               |
| :---------- | :------------------------ |
| `config_id` | Pipeline configuration ID |

```bash theme={null}
curl -X POST https://api.allium.so/api/v1/beam/${CONFIG_ID}/deploy \
  -H "X-API-Key: ${ALLIUM_API_KEY}"
```

**Response:**

```json theme={null}
{ "message": "Pipeline abc123 successfully deployed" }
```