Destroy deployment

Destroy a managed Core instance through Blnk Cloud.

DELETE /deployments/{deployment_id}/destroy

cURL

curl -X DELETE 'https://api.cloud.blnkfinance.com/deployments/deploy_073f7ffe-9dfd-42ce-aa50-d1dca1788adc/destroy' \
  -H 'X-blnk-key: CLOUD_API_KEY'

200

{
  "message": "Deployment destruction initiated"
}

Use this endpoint to destroy a managed deployment. Cloud tears down the hosted Core and its infrastructure. See Managed instances to learn more.

The response means destroy has started, not that it is finished. Status moves to DESTROYING, then DESTROYED. Track progress with Get deployment details or List deployments.

This endpoint destroys managed instances only. For a connected (self-hosted) instance, stop your query agent or remove it from the dashboard to disconnect it from your Cloud workspace.

This action is irreversible. Ledger data on that managed Core is deleted and cannot be recovered.

---

Authorization

Blnk Cloud APIs support any one of the following authentication methods. All of them work with your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.

Pass X-blnk-key: CLOUD_API_KEY or X-blnk-key: OAUTH_ACCESS_TOKEN.

X-blnk-key · string · required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Path

cURL

curl -X DELETE 'https://api.cloud.blnkfinance.com/deployments/deploy_073f7ffe-9dfd-42ce-aa50-d1dca1788adc/destroy' \
  -H 'X-blnk-key: CLOUD_API_KEY'

deployment_id · string · required

Unique id of the deployment to destroy (deploy_...). Do not pass instance_id here.

Response

200

{
  "message": "Deployment destruction initiated"
}

message · string

Confirmation that destroy has started. A follow-up Get deployment details shows status: "DESTROYING" and a destroyed_at timestamp, then DESTROYED.

---

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please contact us or join our Discord community.