Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. time series
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. Transforming ingested data
    2. Querying data
    3. Tracing
    4. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources
    3. Metrics API
    4. Connections API
      1. List all connections GET
      2. Get a single connection GET
      3. Create a connection POST
      4. Remove a connection DELETE
    5. Query API ↗
  7. Alternative to
    1. Lightstep

Remove a connection

Deletes an existing ClickHouse connection.

DELETE https://telemetry.betterstack.com/api/v1/connections/{id}

URL parameters

id
required string

The ID of the connection to delete.

Headers

Authorization
required string

Bearer $TOKEN

204

No Content on successful deletion.

404

Resource with the provided ID was not found.

Response body

{
  "errors": "Resource with the provided ID was not found"
}

This API requires a global API token for authentication, not a team-specific token. Include the token in the Authorization header.

Example cURL

Example
curl --request DELETE \
  --url https://telemetry.betterstack.com/api/v1/connections/123 \
  --header "Authorization: Bearer $TOKEN"

Previous article

Create a connection

Next article

OpenTelemetry-native Lightstep alternative