Update a tag configuration

PATCH {{baseUrl}}/api/v2/metrics/:metric_name/tags

Update the tag configuration of a metric or percentile aggregations of a distribution metric or custom aggregations of a count, rate, or gauge metric. By setting exclude_tags_mode to true the behavior is changed from an allow-list to a deny-list, and tags in the defined list will not be queryable. Can only be used with application keys from users with the Manage Tags for Metrics permission. This endpoint requires a tag configuration to be created first.

Request Body

{"data"=>{"id"=>"test.metric.latency", "type"=>"manage_tags", "attributes"=>{"aggregations"=>[{"space"=>"sum", "time"=>"sum"}, {"space"=>"sum", "time"=>"count"}], "exclude_tags_mode"=>true, "include_percentiles"=>true, "tags"=>["app", "datacenter"]}}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"data":{"attributes":{"aggregations":[{"space":"avg","time":"avg"}],"created_at":"2020-03-25T09:48:37.463835Z","metric_type":"gauge","modified_at":"2020-04-25T09:48:37.463835Z","tags":["app","datacenter"]},"type":"manage_tags"}}