{ "info": { "_postman_id": "19a508c0-bcb2-4cfd-9eea-8efb499bcac0", "name": "CloudZero Allocation Telemetry API", "description": "The CloudZero API V2 enables you to automate the collection, allocation, and analysis of your infrastructure spend. It is organized around REST with predictable resource-oriented URLs, accepts JSON request bodies, returns JSON responses, and uses standard HTTP methods, headers, response codes, and authentication.\n\nContact Support:\n Name: CloudZero", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:22:31.000Z", "updatedAt": "2026-07-28T01:22:31.000Z", "lastUpdatedBy": "35240", "uid": "35240-19a508c0-bcb2-4cfd-9eea-8efb499bcac0" }, "item": [ { "name": "v1", "item": [ { "name": "telemetry", "item": [ { "name": "allocation", "item": [ { "name": "{stream_name}", "item": [ { "name": "sum", "item": [ { "name": "CloudZero Post allocation telemetry records (sum)", "id": "56f19b61-c96d-4105-9644-ea6de41309dc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/sum", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "sum" ], "variable": [ { "id": "7226798a-f69b-455f-80db-0cfff1fdf322", "key": "stream_name", "value": "", "description": "(Required) Name of the allocation telemetry stream." } ] }, "description": "Sends allocation telemetry data that will be summed with any existing data at the same timestamp and granularity within the stream." }, "response": [ { "id": "fc6aea40-6cd7-4e24-a52f-e246fc702d08", "name": "Telemetry records accepted for processing.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/sum", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "sum" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-fc6aea40-6cd7-4e24-a52f-e246fc702d08" }, { "id": "6da8f320-8083-4671-a6f6-f6693d46504c", "name": "Bad request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/sum", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "sum" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-6da8f320-8083-4671-a6f6-f6693d46504c" }, { "id": "9f886a76-d1c7-4cf5-8d3a-5c8fa2a6df0e", "name": "Unauthorized. Invalid or missing API key.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/sum", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "sum" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-9f886a76-d1c7-4cf5-8d3a-5c8fa2a6df0e" }, { "id": "9ae66dd8-993b-4d82-888b-043650fc5fea", "name": "Rate limit exceeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/sum", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "sum" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-9ae66dd8-993b-4d82-888b-043650fc5fea" } ], "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-56f19b61-c96d-4105-9644-ea6de41309dc" } ], "id": "ac45d674-e110-4c74-8f26-2c0dc4ba0eb5", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-ac45d674-e110-4c74-8f26-2c0dc4ba0eb5" }, { "name": "replace", "item": [ { "name": "CloudZero Post allocation telemetry records (replace)", "id": "94b6aa1f-1598-4857-997b-71637e7a6de2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/replace", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "replace" ], "variable": [ { "id": "e8c29bab-3cdf-4095-a78f-0eca6a1876d9", "key": "stream_name", "value": "", "description": "(Required) Name of the allocation telemetry stream." } ] }, "description": "Sends allocation telemetry data that will replace any existing data at the same timestamp and granularity within the stream." }, "response": [ { "id": "5436ba77-f230-433d-9e36-8331b20aee60", "name": "Telemetry records accepted for processing.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/replace", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "replace" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-5436ba77-f230-433d-9e36-8331b20aee60" }, { "id": "3feed025-f742-4619-93a3-7b472ef48b91", "name": "Bad request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/replace", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "replace" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-3feed025-f742-4619-93a3-7b472ef48b91" }, { "id": "7c5a16e2-e4d3-4527-a34b-2e65801a4708", "name": "Unauthorized. Invalid or missing API key.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/replace", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "replace" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-7c5a16e2-e4d3-4527-a34b-2e65801a4708" }, { "id": "c4f11872-5709-4c77-ac43-2085df839179", "name": "Rate limit exceeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"labore_4\": \"\"\n }\n },\n {\n \"timestamp\": \"\",\n \"value\": \"\",\n \"granularity\": \"DAILY\",\n \"element\": {\n \"consequat_4\": \"\",\n \"exercitation_3\": \"\",\n \"consectetur0\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/replace", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "replace" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-c4f11872-5709-4c77-ac43-2085df839179" } ], "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-94b6aa1f-1598-4857-997b-71637e7a6de2" } ], "id": "6f507b52-0326-487a-ac80-2d4cfb720581", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-6f507b52-0326-487a-ac80-2d4cfb720581" }, { "name": "delete", "item": [ { "name": "CloudZero Delete allocation telemetry records", "id": "511f0319-f111-4c0a-a8cd-ce0b33802503", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"granularity\": \"HOURLY\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "delete" ], "variable": [ { "id": "afce8426-319a-4fa2-b3d5-003502479d9b", "key": "stream_name", "value": "", "description": "(Required) Name of the allocation telemetry stream." } ] }, "description": "Deletes any allocation data within the appropriate stream that matches the supplied properties. Timestamp and granularity are minimally required." }, "response": [ { "id": "f48c359a-efa7-4e14-8047-71ef43b32365", "name": "Records deleted successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"granularity\": \"HOURLY\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "delete" ], "variable": [ { "key": "stream_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-f48c359a-efa7-4e14-8047-71ef43b32365" }, { "id": "c1e5efb1-53ce-493e-ae57-b3ae25c8be51", "name": "Bad request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"granularity\": \"HOURLY\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "delete" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-c1e5efb1-53ce-493e-ae57-b3ae25c8be51" }, { "id": "33560bcf-829b-4b04-90df-8836f5ac35fc", "name": "Unauthorized. Invalid or missing API key.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"granularity\": \"HOURLY\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/telemetry/allocation/:stream_name/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "telemetry", "allocation", ":stream_name", "delete" ], "variable": [ { "key": "stream_name" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-33560bcf-829b-4b04-90df-8836f5ac35fc" } ], "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-511f0319-f111-4c0a-a8cd-ce0b33802503" } ], "id": "7b5aba5e-e226-4be6-af9c-c4b0dde94885", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-7b5aba5e-e226-4be6-af9c-c4b0dde94885" } ], "id": "07893a64-8a90-4fe6-939f-b8da194e7ff0", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-07893a64-8a90-4fe6-939f-b8da194e7ff0" } ], "id": "a5a7008f-b468-471f-bdf1-4a2683f7d734", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-a5a7008f-b468-471f-bdf1-4a2683f7d734" } ], "id": "3fd26eb0-86ec-4ac6-a435-8994aa23aac9", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-3fd26eb0-86ec-4ac6-a435-8994aa23aac9" } ], "id": "669e5712-d177-4827-b039-1e74f2a0c988", "createdAt": "2026-07-28T01:22:32.000Z", "updatedAt": "2026-07-28T01:22:32.000Z", "uid": "35240-669e5712-d177-4827-b039-1e74f2a0c988" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.cloudzero.com" } ] }