Timeseries API v1 - DELETE a custom metric

Deletes the specified custom metric. If you delete a metric definition, you lose all of that metric's data, so be careful with deletes.

Built-in metrics can't be deleted.

DELETE	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesIdentifier}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}`

Authentication

To execute this request, you need an access token with DataExport scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
timeseriesIdentifier	string	The ID of the metric to delete.	path	required

Response

Response codes

Code	Description
204	Success. The custom metric has been deleted.

Example

In this example, the request deletes the custom:firewall.connections.dropped custom metric.

The API token is passed in the Authorization header.

Curl

bash
curl -X DELETE \
  https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/custom:firewall.connections.dropped \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/custom:firewall.connections.dropped

Response code

204