Skip to main content
POST
/
api
/
v1
/
beam
/
{config_id}
/
teardown
Teardown Beam Config Handler
curl --request POST \
  --url https://api.allium.so/api/v1/beam/{config_id}/teardown \
  --header 'X-API-KEY: <api-key>'
{
  "message": "<string>"
}
Removes the deployed infrastructure (workers, Kafka topics, subscriptions). The pipeline config is preserved — you can redeploy later. Use delete instead if you want to remove the config entirely.
Required permission: edit — owners and editors.
Path parameters:
ParameterDescription
config_idPipeline configuration ID
curl -X POST https://api.allium.so/api/v1/beam/${CONFIG_ID}/teardown \
  -H "X-API-Key: ${ALLIUM_API_KEY}"
Response: 
{ "message": "Pipeline abc123 successfully torn down" }

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
config_id
string
required

Response

Successful Response

​
message
string
required