Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  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. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Connections API
    7. Collectors API
      1. List all collectors GET
      2. Get a single collector GET
      3. Create a collector POST
      4. Update a collector PATCH
      5. Remove a collector DELETE
      6. List hosts where a collector is running GET
      7. Lists databases monitored by a collector GET
    8. Query API ↗
  7. Alternative to
    1. Lightstep

Remove a collector

Permanently deletes a collector. This action is irreversible and will also remove all associated configurations and stop data collection. The underlying sources and their data will be deleted asynchronously.

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

URL parameters

id
required string

The unique identifier of the collector to delete.

Headers

Authorization
required string

Bearer $TOKEN

204

The collector was successfully marked for deletion.

401

Invalid or missing authentication token.

404

A collector with the specified ID was not found.

Example Request

cURL
curl -X DELETE "https://telemetry.betterstack.com/api/v1/collectors/1" \
     -H "Authorization: Bearer $TOKEN"


Previous article

Update a collector

Next article

List hosts where a collector is running