Remove a source

Permanently deletes an existing source.

Removing a source that has received data requires force=true; older versions remove it without asking.

DELETE https://telemetry.betterstack.com/api/v3/sources/{source_id}

URL parameters

id
required string

Query parameters

force
boolean

Headers

Authorization
required string
204
404

Response body

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

Response body

{
  "errors": "This source has received data. Pass force=true to remove it and permanently delete all of its data."
}
422

Response body

{
  "errors": "Sorry, some values are incorrect",
  "invalid_values": {
    "force": "must be true or false"
  }
}

Example cURL

Example Remove with its data
curl --request DELETE \
  --url https://telemetry.betterstack.com/api/v3/sources/123 \
  --header "Authorization: Bearer $TOKEN"
curl --request DELETE \
  --url "https://telemetry.betterstack.com/api/v3/sources/123?force=true" \
  --header "Authorization: Bearer $TOKEN"