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

# Delete config

> Deletes a pipeline configuration and tears down any active deployment.

```
DELETE /api/v1/beam/{config_id}
```

Deletes the pipeline configuration and tears down any active deployment (Kafka topics, workers, subscriptions). This action is irreversible.

**Path parameters:**

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

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

**Response:**

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

<Warning>
  This permanently removes the pipeline config, all associated filter values, Kafka topics, and deployment resources. Use [teardown](/beam/api-reference/deployment/teardown) if you only want to stop the pipeline while preserving the config.
</Warning>