{ "info": { "_postman_id": "d0d56ca8-0ba8-441b-a271-c32237f55b2c", "name": "Datadog Metrics API", "description": "The Datadog Metrics API allows you to post metrics data to be graphed on Datadog dashboards, query metrics from any time period as timeseries or scalar values, and modify tag configurations for metrics. It also supports viewing tags and volumes for metrics. Metrics data is stored as time series and can be queried programmatically for analysis and visualization.\n\nContact Support:\n Name: Datadog Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T13:12:44.000Z", "updatedAt": "2026-06-05T13:12:44.000Z", "lastUpdatedBy": "35240", "uid": "35240-d0d56ca8-0ba8-441b-a271-c32237f55b2c" }, "item": [ { "name": "api", "item": [ { "name": "v2", "item": [ { "name": "series", "item": [ { "name": "Datadog Submit Metrics", "id": "490e4ad9-f233-4bc6-8d3f-fe11adf1167e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] }, "description": "Submits metrics data points to the Datadog platform. The body should contain a series of metric submissions, each with a metric name, type, data points (timestamp and value pairs), tags, and optional host and resource information. Supports count, rate, gauge, and distribution metric types. The maximum payload size is 512 KB (uncompressed). Each metric series can contain up to 100 data points." }, "response": [ { "id": "8d2dbf48-0281-4446-af91-b7a77a78c944", "name": "Payload accepted for processing", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-8d2dbf48-0281-4446-af91-b7a77a78c944" }, { "id": "e6222362-0e77-47d4-bf18-4f63af5452ad", "name": "Bad request - invalid payload format or missing required fields", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-e6222362-0e77-47d4-bf18-4f63af5452ad" }, { "id": "c317c38e-fb1e-4915-ad9c-0c181134dc23", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-c317c38e-fb1e-4915-ad9c-0c181134dc23" }, { "id": "c182a89d-a39c-4a94-9455-efa2b0fe8ed5", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-c182a89d-a39c-4a94-9455-efa2b0fe8ed5" }, { "id": "fee89de3-45e4-4aaa-9e5b-b63d862b0f5d", "name": "Request timeout", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Request Timeout", "code": 408, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-fee89de3-45e4-4aaa-9e5b-b63d862b0f5d" }, { "id": "1f95fd40-cb84-4874-955a-62443dd71d97", "name": "Payload too large - exceeds 512 KB limit", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"series\": [\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n },\n {\n \"metric\": \"\",\n \"points\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\"\n }\n ],\n \"type\": 3,\n \"tags\": [\n \"\",\n \"\"\n ],\n \"host\": \"\",\n \"resources\": [\n {\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"name\": \"\",\n \"type\": \"\"\n }\n ],\n \"interval\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/series", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "series" ] } }, "status": "Request Entity Too Large", "code": 413, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-1f95fd40-cb84-4874-955a-62443dd71d97" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-490e4ad9-f233-4bc6-8d3f-fe11adf1167e" } ], "id": "af18ab07-1d32-48e1-9b2d-e477df5b1daa", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-af18ab07-1d32-48e1-9b2d-e477df5b1daa" }, { "name": "query", "item": [ { "name": "timeseries", "item": [ { "name": "Datadog Query Timeseries Data", "id": "97752f43-84df-4340-97b5-5b5954c63381", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"timeseries_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n }\n ],\n \"interval\": \"\",\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/timeseries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "timeseries" ] }, "description": "Queries timeseries metric data for the specified time range and metric queries. Supports multiple metric queries in a single request. Returns time series data including timestamps, values, and associated metadata. The query uses Datadog's metrics query language supporting rollup, aggregation, and arithmetic operations." }, "response": [ { "id": "ed125305-3d08-4502-bc74-ced49b17597f", "name": "Successful response with timeseries data", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"timeseries_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n }\n ],\n \"interval\": \"\",\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/timeseries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "timeseries" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"times\": [\n \"\",\n \"\"\n ],\n \"series\": [\n {\n \"query_index\": \"\",\n \"unit\": [\n {\n \"family\": \"\",\n \"name\": \"\"\n },\n {\n \"family\": \"\",\n \"name\": \"\"\n }\n ],\n \"group_tags\": [\n \"\",\n \"\"\n ],\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"query_index\": \"\",\n \"unit\": [\n {\n \"family\": \"\",\n \"name\": \"\"\n },\n {\n \"family\": \"\",\n \"name\": \"\"\n }\n ],\n \"group_tags\": [\n \"\",\n \"\"\n ],\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-ed125305-3d08-4502-bc74-ced49b17597f" }, { "id": "0487a05d-50cb-4232-a926-886f7195f476", "name": "Bad request - invalid query syntax or parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"timeseries_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n }\n ],\n \"interval\": \"\",\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/timeseries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "timeseries" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-0487a05d-50cb-4232-a926-886f7195f476" }, { "id": "509549ed-8061-4aac-8b1d-3271889c3016", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"timeseries_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n }\n ],\n \"interval\": \"\",\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/timeseries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "timeseries" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-509549ed-8061-4aac-8b1d-3271889c3016" }, { "id": "74c75952-bb4e-4f83-b01d-5d3c1e98c655", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"timeseries_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n }\n ],\n \"interval\": \"\",\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/timeseries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "timeseries" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-74c75952-bb4e-4f83-b01d-5d3c1e98c655" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-97752f43-84df-4340-97b5-5b5954c63381" } ], "id": "40ca90cf-bad7-4bee-b382-a2f489210969", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-40ca90cf-bad7-4bee-b382-a2f489210969" }, { "name": "scalar", "item": [ { "name": "Datadog Query Scalar Data", "id": "73f2052f-5160-4dae-855c-24927f0c6bcc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"scalar_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n }\n ],\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/scalar", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "scalar" ] }, "description": "Queries scalar metric data for the specified time range and returns a single aggregated value per query formula. Useful for computing summary statistics such as averages, sums, or percentiles over a time window. Supports multiple formulas and metric queries in a single request." }, "response": [ { "id": "99191d07-10db-4024-a9ba-b1e54601f0e3", "name": "Successful response with scalar query results", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"scalar_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n }\n ],\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/scalar", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "scalar" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"columns\": [\n {\n \"name\": \"\",\n \"values\": [\n \"\",\n \"\"\n ],\n \"group\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ]\n },\n {\n \"name\": \"\",\n \"values\": [\n \"\",\n \"\"\n ],\n \"group\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ]\n }\n ]\n }\n }\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-99191d07-10db-4024-a9ba-b1e54601f0e3" }, { "id": "96eb22a1-ee14-4064-a046-c1b49774c39b", "name": "Bad request - invalid query syntax or parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"scalar_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n }\n ],\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/scalar", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "scalar" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-96eb22a1-ee14-4064-a046-c1b49774c39b" }, { "id": "56ffd5f0-f2ae-411c-9f55-413c760c46e6", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"scalar_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n }\n ],\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/scalar", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "scalar" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-56ffd5f0-f2ae-411c-9f55-413c760c46e6" }, { "id": "1c1b5d88-720d-4c2e-b75d-5440e35566d4", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"scalar_request\",\n \"attributes\": {\n \"from\": \"\",\n \"to\": \"\",\n \"queries\": [\n {\n \"name\": \"\",\n \"data_source\": \"metrics\",\n \"query\": \"\"\n },\n {\n \"name\": \"\",\n \"data_source\": \"cloud_cost\",\n \"query\": \"\"\n }\n ],\n \"formulas\": [\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n },\n {\n \"formula\": \"\",\n \"alias\": \"\",\n \"limit\": {\n \"count\": \"\",\n \"order\": \"desc\"\n }\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/query/scalar", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "query", "scalar" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-1c1b5d88-720d-4c2e-b75d-5440e35566d4" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-73f2052f-5160-4dae-855c-24927f0c6bcc" } ], "id": "26ca833f-e88b-4e61-9668-1ceccbc7edb8", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-26ca833f-e88b-4e61-9668-1ceccbc7edb8" } ], "id": "d9b61579-ca91-4aac-a520-841e33df40a4", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-d9b61579-ca91-4aac-a520-841e33df40a4" }, { "name": "metrics", "item": [ { "name": "{metric_name}", "item": [ { "name": "tags", "item": [ { "name": "Datadog List Tags by Metric Name", "id": "4fc17732-2637-484f-bc0a-c79248392ea3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "id": "652da166-a63e-4ba6-b1b0-579b8dbb5588", "key": "metric_name", "value": "", "description": "(Required) The name of the metric to manage tag configuration for (e.g., system.cpu.user)" } ] }, "description": "Returns the tag configuration for a specified metric including all configured tag keys, aggregation types, and exclude percentiles setting. Only available for custom metrics with tag configurations." }, "response": [ { "id": "aa918bd8-b7b5-4d46-82c2-f5cb62db5f86", "name": "Successful response with metric tag configuration", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"id\": \"\",\n \"type\": \"manage_tags\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"metric_type\": \"rate\",\n \"include_percentiles\": \"\",\n \"aggregations\": [\n {\n \"space\": \"avg\",\n \"time\": \"sum\"\n },\n {\n \"space\": \"min\",\n \"time\": \"min\"\n }\n ],\n \"created_at\": \"\",\n \"modified_at\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-aa918bd8-b7b5-4d46-82c2-f5cb62db5f86" }, { "id": "560105d2-c213-4b46-ad41-b624328d4296", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-560105d2-c213-4b46-ad41-b624328d4296" }, { "id": "25551ef7-0b54-430c-bff1-4d144d95e272", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-25551ef7-0b54-430c-bff1-4d144d95e272" }, { "id": "c4719fa6-218d-4345-a8bf-09dac66af953", "name": "Not found - metric does not exist or has no tag configuration", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-c4719fa6-218d-4345-a8bf-09dac66af953" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-4fc17732-2637-484f-bc0a-c79248392ea3" }, { "name": "Datadog Create a Tag Configuration", "id": "21dc4059-de56-4569-bee8-81403165255d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "id": "3482b7a0-6b16-4d2a-9315-050fa0471bf6", "key": "metric_name", "value": "", "description": "(Required) The name of the metric to manage tag configuration for (e.g., system.cpu.user)" } ] }, "description": "Creates a tag configuration for a specified custom metric. Allows specifying which tag keys to include, the metric type, whether to exclude percentile aggregations, and aggregation settings. Tag configurations reduce the number of custom metrics by limiting which tag combinations are stored." }, "response": [ { "id": "784235ed-f7f1-481c-9568-54d794cd8fdc", "name": "Created - tag configuration created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"id\": \"\",\n \"type\": \"manage_tags\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"metric_type\": \"rate\",\n \"include_percentiles\": \"\",\n \"aggregations\": [\n {\n \"space\": \"avg\",\n \"time\": \"sum\"\n },\n {\n \"space\": \"min\",\n \"time\": \"min\"\n }\n ],\n \"created_at\": \"\",\n \"modified_at\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-784235ed-f7f1-481c-9568-54d794cd8fdc" }, { "id": "460d0b13-37cf-4ad7-9082-2a8c1af1e76d", "name": "Bad request - invalid tag configuration parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-460d0b13-37cf-4ad7-9082-2a8c1af1e76d" }, { "id": "6dbbf585-da61-4e24-88dc-15cfea4b41e5", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-6dbbf585-da61-4e24-88dc-15cfea4b41e5" }, { "id": "4318c816-380b-4743-8121-df62f45e57d4", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-4318c816-380b-4743-8121-df62f45e57d4" }, { "id": "8374f623-4e46-454e-9078-33e183ef2c0f", "name": "Conflict - tag configuration already exists for this metric", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"metric_type\": \"rate\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-8374f623-4e46-454e-9078-33e183ef2c0f" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-21dc4059-de56-4569-bee8-81403165255d" }, { "name": "Datadog Update a Tag Configuration", "id": "597d9a4e-d706-436e-8222-ceada4ba3e68", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "id": "a8e487aa-7b60-46a5-bbbc-9948186f6d50", "key": "metric_name", "value": "", "description": "(Required) The name of the metric to manage tag configuration for (e.g., system.cpu.user)" } ] }, "description": "Updates the tag configuration for a specified custom metric. Supports partial updates using JSON merge patch semantics. Allows changing the set of tag keys, aggregation types, and exclude percentiles settings." }, "response": [ { "id": "a4a6ef5e-f84b-4767-8257-ef52fd14d59d", "name": "Successful response with updated tag configuration", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"id\": \"\",\n \"type\": \"manage_tags\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"metric_type\": \"rate\",\n \"include_percentiles\": \"\",\n \"aggregations\": [\n {\n \"space\": \"avg\",\n \"time\": \"sum\"\n },\n {\n \"space\": \"min\",\n \"time\": \"min\"\n }\n ],\n \"created_at\": \"\",\n \"modified_at\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-a4a6ef5e-f84b-4767-8257-ef52fd14d59d" }, { "id": "c9d3c000-4128-4227-94f0-ee488083a1c4", "name": "Bad request - invalid tag configuration parameters", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-c9d3c000-4128-4227-94f0-ee488083a1c4" }, { "id": "ddf41943-d8c2-455e-959b-4863e95180ed", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-ddf41943-d8c2-455e-959b-4863e95180ed" }, { "id": "8711707a-580e-4b64-86a6-df8bbcf903ce", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-8711707a-580e-4b64-86a6-df8bbcf903ce" }, { "id": "59ca8225-3ce3-467b-80f6-983834e71de0", "name": "Not found - metric tag configuration does not exist", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"manage_tags\",\n \"id\": \"\",\n \"attributes\": {\n \"tags\": [\n \"\",\n \"\"\n ],\n \"include_percentiles\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-59ca8225-3ce3-467b-80f6-983834e71de0" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-597d9a4e-d706-436e-8222-ceada4ba3e68" }, { "name": "Datadog Delete a Tag Configuration", "id": "6a7cea14-8781-4465-a66a-1267ed9827e3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "id": "cbc02948-912b-4d77-b178-caa938d711f1", "key": "metric_name", "value": "", "description": "(Required) The name of the metric to manage tag configuration for (e.g., system.cpu.user)" } ] }, "description": "Deletes the tag configuration for a specified custom metric. After deletion, all tag combinations for the metric will be stored again, which may increase custom metric usage. This action cannot be undone." }, "response": [ { "id": "5316159a-c4ba-40c8-b670-d2d69fb64531", "name": "No content - tag configuration deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-5316159a-c4ba-40c8-b670-d2d69fb64531" }, { "id": "f91457fc-6baa-44d9-9d2f-14e89f2b2f2b", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-f91457fc-6baa-44d9-9d2f-14e89f2b2f2b" }, { "id": "3c3da4ee-a173-4f8e-8ed6-d488c161b5eb", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-3c3da4ee-a173-4f8e-8ed6-d488c161b5eb" }, { "id": "3ad8dd25-77d0-40e1-beae-2c93db343653", "name": "Not found - metric tag configuration does not exist", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v2/metrics/:metric_name/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "metrics", ":metric_name", "tags" ], "variable": [ { "key": "metric_name" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-3ad8dd25-77d0-40e1-beae-2c93db343653" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-6a7cea14-8781-4465-a66a-1267ed9827e3" } ], "id": "b6a47591-ead2-4d9e-a0d3-e9c3f0fa914e", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-b6a47591-ead2-4d9e-a0d3-e9c3f0fa914e" } ], "id": "d3ed7f5b-1fa1-44bf-851b-dfc8fb841ca2", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-d3ed7f5b-1fa1-44bf-851b-dfc8fb841ca2" } ], "id": "64d5c320-1867-4edd-aca5-6a33dfe0a21d", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-64d5c320-1867-4edd-aca5-6a33dfe0a21d" } ], "id": "8dc9ab7c-1ef6-49d9-8e25-04a73304a516", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-8dc9ab7c-1ef6-49d9-8e25-04a73304a516" }, { "name": "v1", "item": [ { "name": "metrics", "item": [ { "name": "Datadog List Active Metrics", "id": "7516073f-5440-4cfa-a39e-729c841a401c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v1/metrics?from=&host=&tag_filter=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "metrics" ], "query": [ { "description": "(Required) POSIX timestamp (seconds) indicating the start of the time window to query active metrics", "key": "from", "value": "" }, { "description": "Filter metrics by the hostname that is actively reporting the metric", "key": "host", "value": "" }, { "description": "Filter metrics by tag key or key:value pair (e.g., env:prod)", "key": "tag_filter", "value": "" } ] }, "description": "Returns the list of actively reporting metric names for a given hour. Optionally filters by host and metric name prefix. Metrics are considered active if they reported at least one data point within the last 48 hours. Useful for metric discovery and auditing." }, "response": [ { "id": "59e66335-202f-441c-b5f2-c8376180c941", "name": "Successful response with list of active metrics", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v1/metrics?from=&host=&tag_filter=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "metrics" ], "query": [ { "description": "(Required) POSIX timestamp (seconds) indicating the start of the time window to query active metrics", "key": "from", "value": "" }, { "description": "Filter metrics by the hostname that is actively reporting the metric", "key": "host", "value": "" }, { "description": "Filter metrics by tag key or key:value pair (e.g., env:prod)", "key": "tag_filter", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"from\": \"\",\n \"metrics\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-59e66335-202f-441c-b5f2-c8376180c941" }, { "id": "4c054ba4-20a3-4cbc-8b5d-46cd0ddd2143", "name": "Bad request - invalid or missing required parameters", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v1/metrics?from=&host=&tag_filter=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "metrics" ], "query": [ { "description": "(Required) POSIX timestamp (seconds) indicating the start of the time window to query active metrics", "key": "from", "value": "" }, { "description": "Filter metrics by the hostname that is actively reporting the metric", "key": "host", "value": "" }, { "description": "Filter metrics by tag key or key:value pair (e.g., env:prod)", "key": "tag_filter", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-4c054ba4-20a3-4cbc-8b5d-46cd0ddd2143" }, { "id": "85ad9141-1279-438f-904f-afd75a7f5153", "name": "Unauthorized - missing or invalid API key", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v1/metrics?from=&host=&tag_filter=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "metrics" ], "query": [ { "description": "(Required) POSIX timestamp (seconds) indicating the start of the time window to query active metrics", "key": "from", "value": "" }, { "description": "Filter metrics by the hostname that is actively reporting the metric", "key": "host", "value": "" }, { "description": "Filter metrics by tag key or key:value pair (e.g., env:prod)", "key": "tag_filter", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-85ad9141-1279-438f-904f-afd75a7f5153" }, { "id": "bbcfcd91-3990-4a92-86c6-314d97e8cf71", "name": "Forbidden - insufficient permissions for this operation", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "DD-API-KEY", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/v1/metrics?from=&host=&tag_filter=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "metrics" ], "query": [ { "description": "(Required) POSIX timestamp (seconds) indicating the start of the time window to query active metrics", "key": "from", "value": "" }, { "description": "Filter metrics by the hostname that is actively reporting the metric", "key": "host", "value": "" }, { "description": "Filter metrics by tag key or key:value pair (e.g., env:prod)", "key": "tag_filter", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-bbcfcd91-3990-4a92-86c6-314d97e8cf71" } ], "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-7516073f-5440-4cfa-a39e-729c841a401c" } ], "id": "3968516c-dbf2-4ea4-a73a-66461a9c00bf", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-3968516c-dbf2-4ea4-a73a-66461a9c00bf" } ], "id": "361f8ebd-a5b4-434b-acd8-55c0060f113a", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-361f8ebd-a5b4-434b-acd8-55c0060f113a" } ], "id": "1561dc05-28fe-4a9d-83dc-97370bc811cf", "createdAt": "2026-06-05T13:12:45.000Z", "updatedAt": "2026-06-05T13:12:45.000Z", "uid": "35240-1561dc05-28fe-4a9d-83dc-97370bc811cf" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "DD-API-KEY", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.datadoghq.com" } ] }