delete
https://api.doit.com/analytics/v1/custom-metrics/
Deletes a custom metric. This cannot be undone. Requires the
analytics:calculatedMetrics entitlement and a metrics write
permission, and only the owner can delete a metric. Send the
metric's etag in If-Match.
A metric that a report or an alert uses cannot be deleted. Remove it
from them first.
A retry with the same Idempotency-Key returns the first 204. A
new request for a metric that no longer exists, including one that
is already deleted, returns 404 not_found: treat it as gone.
With dryRun=true, every check runs and nothing is deleted.
Errors (RFC 9457 Problem Details, code field):
400 idempotency_key_required: noIdempotency-Keyheader.400 tenant_id_required: a caller with access to more than one
customer sent noX-Tenant-Id.403 analytics.feature_not_entitled: the customer does not have
the calculated metrics entitlement.403 analytics.custom_metric_not_owner: the caller does not own the
metric.403 forbidden: no metrics write permission, a read-only token,
or anX-Tenant-Idthat the credential cannot access.404 not_found: no custom metric with this id for the customer,
including a metric that is already deleted.409 delete_blocked_by_dependencies: reports, allocations or alerts
use the metric.detailshas one entry per user, withissue
set toused_by_report,used_by_allocationorused_by_alert,
andresourceTypeandresourceIdnaming that user, for example
{"issue": "used_by_report", "resourceType": "report", "resourceId": "..."}. An allocation uses the metric when one of
its splits is weighted by it.409 idempotency_request_in_progress: a request with the same
Idempotency-Keyis still running. Retry with backoff.412 precondition_failed:If-Matchdoes not match the current
etag. Read the metric again, then retry.422 idempotency_key_reused: theIdempotency-Keywas used for
another request.428 precondition_required: noIf-Matchheader.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…