{ "info": { "_postman_id": "f3b351f2-140e-4db5-85fe-6f653b2ebd43", "name": "Vendor API V3 apps clusters API", "description": "Manage enterprise portal users, install options, branding, documentation, email templates, and access control.\n\nContact Support:\n Name: Replicated, Inc.\n Email: info@replicated.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "lastUpdatedBy": "35240", "uid": "35240-f3b351f2-140e-4db5-85fe-6f653b2ebd43" }, "item": [ { "name": "app", "item": [ { "name": "{app_id}", "item": [ { "name": "cluster-usage", "item": [ { "name": "List cluster usage.", "id": "37b744bb-c52d-458e-b187-0e2c89f186de", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "id": "9c5159ae-47f4-4c4d-a2ce-d5b7e3fddb50", "key": "app_id", "value": "", "description": "(Required) App identifier" } ] }, "description": "List cluster distribution/version usage by customers.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "c621c354-4ea3-467a-ba4e-ce2876f3b63d", "name": "ListClusterUsageResponse contains the response to list cluster usage", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "key": "app_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"clusterUsageDetails\": [\n {\n \"channel_id\": \"\",\n \"channel_sequence\": \"\",\n \"cloud_provider\": \"\",\n \"is_airgap\": \"\",\n \"is_kurl\": \"\",\n \"kots_version\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"number_of_instances\": \"\",\n \"version_label\": \"\"\n },\n {\n \"channel_id\": \"\",\n \"channel_sequence\": \"\",\n \"cloud_provider\": \"\",\n \"is_airgap\": \"\",\n \"is_kurl\": \"\",\n \"kots_version\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"number_of_instances\": \"\",\n \"version_label\": \"\"\n }\n ],\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-c621c354-4ea3-467a-ba4e-ce2876f3b63d" }, { "id": "7968533f-3899-4527-be46-6016eb645286", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "key": "app_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-7968533f-3899-4527-be46-6016eb645286" }, { "id": "a64e1890-0086-4a7e-a45f-fe9f5262f5af", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "key": "app_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-a64e1890-0086-4a7e-a45f-fe9f5262f5af" }, { "id": "c92ead3f-d979-4a3a-98e5-e75ab7c08433", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "key": "app_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-c92ead3f-d979-4a3a-98e5-e75ab7c08433" }, { "id": "007f1f82-8760-4794-820b-67e6eb68a965", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/app/:app_id/cluster-usage", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "cluster-usage" ], "variable": [ { "key": "app_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-007f1f82-8760-4794-820b-67e6eb68a965" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-37b744bb-c52d-458e-b187-0e2c89f186de" } ], "id": "f3083de7-82ad-4865-bd75-e4b9f5b7a87d", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-f3083de7-82ad-4865-bd75-e4b9f5b7a87d" } ], "id": "cd329f78-3eeb-427b-9798-0cfc4082a41a", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-cd329f78-3eeb-427b-9798-0cfc4082a41a" } ], "id": "83cdc112-dd4d-4d7e-8ab6-838b6574464c", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-83cdc112-dd4d-4d7e-8ab6-838b6574464c" }, { "name": "cluster", "item": [ { "name": "filters", "item": [ { "name": "Get clusters filters.", "id": "f9d616fc-6893-4b4f-964d-c79513dc9804", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] }, "description": "Required RBAC Policy: kots/cluster/list" }, "response": [ { "id": "ceadebbf-6d05-4784-bb1b-26e2df7fba40", "name": "GetClusterFiltersResponse contains the response to get clusters filters", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"earliest_cluster_date_days_ago\": \"\",\n \"max_cost\": \"\",\n \"max_duration_minutes\": \"\",\n \"max_node_groups\": \"\",\n \"max_nodes\": \"\",\n \"max_ttl_minutes\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-ceadebbf-6d05-4784-bb1b-26e2df7fba40" }, { "id": "3618aea0-cf01-4d84-bcab-8b9d7b5d9aed", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-3618aea0-cf01-4d84-bcab-8b9d7b5d9aed" }, { "id": "022f5e0d-79e7-481e-9a1c-2c64740c6d99", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-022f5e0d-79e7-481e-9a1c-2c64740c6d99" }, { "id": "f73ecf90-5c32-465e-8484-60aa30b691a0", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-f73ecf90-5c32-465e-8484-60aa30b691a0" }, { "id": "41699781-2440-43d7-bc6b-5213ff2dc281", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/filters", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "filters" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-41699781-2440-43d7-bc6b-5213ff2dc281" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-f9d616fc-6893-4b4f-964d-c79513dc9804" } ], "id": "2ed7bbfe-6169-40ad-8e1b-9482e11166d1", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-2ed7bbfe-6169-40ad-8e1b-9482e11166d1" }, { "name": "quotas", "item": [ { "name": "List cluster quotas.", "id": "51a560c3-a22e-43ad-8aa6-8e0f07a19ed4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "response": [ { "id": "8b6ce0a0-da98-4e6a-9a92-3928ba11674b", "name": "ListClusterQuotasResponse contains the response to list cluster quotas", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster_quotas\": [\n {\n \"current_value\": \"\",\n \"default_value\": \"\",\n \"in_use\": \"\",\n \"name\": \"\",\n \"queued\": \"\",\n \"unit\": \"\"\n },\n {\n \"current_value\": \"\",\n \"default_value\": \"\",\n \"in_use\": \"\",\n \"name\": \"\",\n \"queued\": \"\",\n \"unit\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-8b6ce0a0-da98-4e6a-9a92-3928ba11674b" }, { "id": "fb359eae-c8e9-450c-b443-2693fb0ffdba", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-fb359eae-c8e9-450c-b443-2693fb0ffdba" }, { "id": "96e7db1c-df43-4765-bbac-6e23b12eccb4", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-96e7db1c-df43-4765-bbac-6e23b12eccb4" }, { "id": "914ad423-5593-4dca-9916-5ff87fb7a1d4", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-914ad423-5593-4dca-9916-5ff87fb7a1d4" }, { "id": "ec0df065-5d55-4e30-b556-49bb503c1ade", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/quotas", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "quotas" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-ec0df065-5d55-4e30-b556-49bb503c1ade" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-51a560c3-a22e-43ad-8aa6-8e0f07a19ed4" } ], "id": "32e8e23f-4bd3-4a9a-a8b4-1b8d3871c899", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-32e8e23f-4bd3-4a9a-a8b4-1b8d3871c899" }, { "name": "stats", "item": [ { "name": "Get clusters stats.", "id": "cd682347-0210-412f-9902-69539f257d9e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] }, "description": "Required RBAC Policy: kots/cluster/list" }, "response": [ { "id": "a1cbcd86-84ac-443f-a79f-f51540462c52", "name": "GetClusterStatsResponse contains the response to get clusters stats", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster_count\": \"\",\n \"cost\": \"\",\n \"credit_balance\": \"\",\n \"error\": \"\",\n \"node_minutes\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-a1cbcd86-84ac-443f-a79f-f51540462c52" }, { "id": "3e484d64-61b1-48f1-8de5-7eaa7d09168c", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-3e484d64-61b1-48f1-8de5-7eaa7d09168c" }, { "id": "229be51f-8e33-47f5-af39-15e894b28854", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-229be51f-8e33-47f5-af39-15e894b28854" }, { "id": "30df2337-9bd9-4f90-a86d-cd2ad6a696a2", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-30df2337-9bd9-4f90-a86d-cd2ad6a696a2" }, { "id": "34045046-00f3-42c0-9efe-1ad9c1447dac", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/stats", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "stats" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-34045046-00f3-42c0-9efe-1ad9c1447dac" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-cd682347-0210-412f-9902-69539f257d9e" } ], "id": "e90cc405-fd0f-4a01-9e81-d34d1c2078d2", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-e90cc405-fd0f-4a01-9e81-d34d1c2078d2" }, { "name": "versions", "item": [ { "name": "List cluster versions.", "id": "9aef0f8a-80d4-4af0-a6ce-489eeba68488", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "response": [ { "id": "676ffea4-cadd-4344-bcc3-259f354894d3", "name": "ListClusterVersionsResponse contains the response to list clusters", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster-versions\": [\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n },\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-676ffea4-cadd-4344-bcc3-259f354894d3" }, { "id": "6d702f8d-f162-4eb8-80ed-7320e965e0a4", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-6d702f8d-f162-4eb8-80ed-7320e965e0a4" }, { "id": "a8e373c6-1d58-4416-a8a6-423f353844f5", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-a8e373c6-1d58-4416-a8a6-423f353844f5" }, { "id": "ec8805f9-9444-48f7-a6cb-ee14ea88411e", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-ec8805f9-9444-48f7-a6cb-ee14ea88411e" }, { "id": "1ebea4d7-3fc7-4a6b-93d8-194891e7b462", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/versions", "host": [ "{{baseUrl}}" ], "path": [ "cluster", "versions" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-1ebea4d7-3fc7-4a6b-93d8-194891e7b462" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-9aef0f8a-80d4-4af0-a6ce-489eeba68488" } ], "id": "73d07e68-e875-40ed-bd8f-78a2d7101814", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-73d07e68-e875-40ed-bd8f-78a2d7101814" }, { "name": "{cluster_id}", "item": [ { "name": "kubeconfig", "item": [ { "name": "Get the kubeconfig for a test cluster.", "id": "c8d0454c-fe47-459e-bf7e-3d276e177df0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "id": "b86e0f7f-8bd0-4858-8751-aebd1d345caf", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/kubeconfig" }, "response": [ { "id": "ec7025b8-b28b-40a1-9b8d-075c90af14c8", "name": "GetClusterKubeconfigResponse contains the response to get a cluster kubeconfig", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"kubeconfig\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-ec7025b8-b28b-40a1-9b8d-075c90af14c8" }, { "id": "e54a10b3-a88c-4e84-a6fd-77bcfdcd5783", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-e54a10b3-a88c-4e84-a6fd-77bcfdcd5783" }, { "id": "80ff8495-3a2a-43fc-8430-c5e578a8a95b", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-80ff8495-3a2a-43fc-8430-c5e578a8a95b" }, { "id": "8aca521f-55a0-4634-91a4-880def1450e3", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-8aca521f-55a0-4634-91a4-880def1450e3" }, { "id": "e77a74c6-01fd-40f3-9157-0707a5635551", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/kubeconfig", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "kubeconfig" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-e77a74c6-01fd-40f3-9157-0707a5635551" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-c8d0454c-fe47-459e-bf7e-3d276e177df0" } ], "id": "69999e4d-eaeb-4155-9bae-24f6d5a2f8e4", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-69999e4d-eaeb-4155-9bae-24f6d5a2f8e4" }, { "name": "nodegroup", "item": [ { "name": "{nodegroup_id}", "item": [ { "name": "Update a nodegroup for a cluster.", "id": "e017d682-2169-45ed-b29c-0970ef3747c6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "id": "22732414-8de4-4eb7-abe2-2d713b271724", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" }, { "id": "a9383073-21bd-4b7b-8894-b1e23f4bd6b8", "key": "nodegroup_id", "value": "", "description": "(Required) Nodegroup identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/nodegroup" }, "response": [ { "id": "015d2535-2c44-42e6-a323-2141b53e1f03", "name": "UpdateClusterNodegroupResponse contains the response to update a cluster nodegroup", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "key": "cluster_id" }, { "key": "nodegroup_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-015d2535-2c44-42e6-a323-2141b53e1f03" }, { "id": "b86e8f3c-4cba-4403-a3e9-59e4f8ae1439", "name": "updateClusterNodegroupErrorResponse contains error information", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "key": "cluster_id" }, { "key": "nodegroup_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"validationError\": {\n \"errors\": [\n \"\",\n \"\"\n ],\n \"supported_distributions\": [\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n },\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-b86e8f3c-4cba-4403-a3e9-59e4f8ae1439" }, { "id": "c0cb5fae-a667-443a-a4bf-d6b6882baf4e", "name": "Return if the caller is not authorized", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "key": "cluster_id" }, { "key": "nodegroup_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-c0cb5fae-a667-443a-a4bf-d6b6882baf4e" }, { "id": "4c9149d8-19f4-4ecf-affc-6d49ccbef700", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "key": "cluster_id" }, { "key": "nodegroup_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-4c9149d8-19f4-4ecf-affc-6d49ccbef700" }, { "id": "a2cb7d5c-07ab-4b7f-a79e-63aa83f244fb", "name": "Returned on resource not found", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"maxCount\": \"\",\n \"minCount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/nodegroup/:nodegroup_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "nodegroup", ":nodegroup_id" ], "variable": [ { "key": "cluster_id" }, { "key": "nodegroup_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-a2cb7d5c-07ab-4b7f-a79e-63aa83f244fb" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-e017d682-2169-45ed-b29c-0970ef3747c6" } ], "id": "236d53e7-aa20-45d4-9ee9-678bf8681338", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-236d53e7-aa20-45d4-9ee9-678bf8681338" } ], "id": "d99e025a-4867-4fa2-af92-dca37bf68236", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-d99e025a-4867-4fa2-af92-dca37bf68236" }, { "name": "port", "item": [ { "name": "{port_number}", "item": [ { "name": "Deletes a port from a cluster.", "id": "5d512f69-d223-4d64-ab74-c44be1ad3cc5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "id": "78d48b46-0021-4667-b484-a7242f554b13", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" }, { "id": "27442965-bf70-490c-8930-ead36ffad269", "key": "port_number", "value": "", "description": "(Required) Port Number" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/port/delete" }, "response": [ { "id": "f2aa34bc-4371-407d-94a1-5f8053e07cd6", "name": "DeleteClusterPortResponse contains the response to a delete cluster port request", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "key": "cluster_id" }, { "key": "port_number" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"ports\": [\n {\n \"addon_guid\": \"\",\n \"addon_id\": \"\",\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"exposed_ports\": [\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n },\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n }\n ],\n \"hostname\": \"\",\n \"is_wildcard\": \"\",\n \"port_name\": \"\",\n \"state\": \"\",\n \"upstream_port\": \"\"\n },\n {\n \"addon_guid\": \"\",\n \"addon_id\": \"\",\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"exposed_ports\": [\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n },\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n }\n ],\n \"hostname\": \"\",\n \"is_wildcard\": \"\",\n \"port_name\": \"\",\n \"state\": \"\",\n \"upstream_port\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-f2aa34bc-4371-407d-94a1-5f8053e07cd6" }, { "id": "d0333080-c0b5-40e0-a32b-84e1fb601475", "name": "Returned on bad input", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "key": "cluster_id" }, { "key": "port_number" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-d0333080-c0b5-40e0-a32b-84e1fb601475" }, { "id": "df382e6a-5621-4721-b4a7-73cc17f0d388", "name": "Return if the caller is not authorized", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "key": "cluster_id" }, { "key": "port_number" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-df382e6a-5621-4721-b4a7-73cc17f0d388" }, { "id": "517305ce-d755-45df-a24d-06c00c96c1ed", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "key": "cluster_id" }, { "key": "port_number" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-517305ce-d755-45df-a24d-06c00c96c1ed" }, { "id": "c7a8a463-c9d4-4c91-a238-c033372cc45d", "name": "Returned on resource not found", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port/:port_number?protocols=,", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port", ":port_number" ], "query": [ { "description": "(Required) Protocols", "key": "protocols", "value": "," } ], "variable": [ { "key": "cluster_id" }, { "key": "port_number" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-c7a8a463-c9d4-4c91-a238-c033372cc45d" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-5d512f69-d223-4d64-ab74-c44be1ad3cc5" } ], "id": "3e39dd62-94c6-4c21-a5ce-4b035688fd0e", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-3e39dd62-94c6-4c21-a5ce-4b035688fd0e" }, { "name": "Exposes a port on a cluster.", "id": "27062fed-7382-463b-948c-eff9cc2da5ff", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"port\": \"\",\n \"protocols\": [\n \"\",\n \"\"\n ],\n \"is_wildcard\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port" ], "variable": [ { "id": "24b0735f-9932-46a1-be02-00520e45301c", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/port/expose" }, "response": [ { "id": "672b29d8-c873-4028-9ac5-05d205a418b6", "name": "CreateClusterPortResponse contains the response to a create cluster port request", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"port\": \"\",\n \"protocols\": [\n \"\",\n \"\"\n ],\n \"is_wildcard\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"addon\": {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n \"port\": {\n \"addon_guid\": \"\",\n \"addon_id\": \"\",\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"exposed_ports\": [\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n },\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n }\n ],\n \"hostname\": \"\",\n \"is_wildcard\": \"\",\n \"port_name\": \"\",\n \"state\": \"\",\n \"upstream_port\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-672b29d8-c873-4028-9ac5-05d205a418b6" }, { "id": "07f78f49-e429-4a69-bfcb-6fc10404b143", "name": "Return if the caller is not authorized", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"port\": \"\",\n \"protocols\": [\n \"\",\n \"\"\n ],\n \"is_wildcard\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-07f78f49-e429-4a69-bfcb-6fc10404b143" }, { "id": "caa93da6-eb9f-45eb-b335-3f9930988dea", "name": "Returned if the caller does not have the needed permission", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"port\": \"\",\n \"protocols\": [\n \"\",\n \"\"\n ],\n \"is_wildcard\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-caa93da6-eb9f-45eb-b335-3f9930988dea" }, { "id": "abbd7124-e4f0-4b86-805b-a8c206196447", "name": "Returned on resource not found", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"port\": \"\",\n \"protocols\": [\n \"\",\n \"\"\n ],\n \"is_wildcard\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/port", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "port" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-abbd7124-e4f0-4b86-805b-a8c206196447" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-27062fed-7382-463b-948c-eff9cc2da5ff" } ], "id": "4a3b8169-07b0-4fb9-b2a0-aa7a8b2183c5", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-4a3b8169-07b0-4fb9-b2a0-aa7a8b2183c5" }, { "name": "ports", "item": [ { "name": "Lists ports for a cluster.", "id": "7a6eef4d-46ab-48f6-b53e-4285540f34a8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "id": "7e9f25e4-f1f1-45bb-95d7-b3dd6f027ec1", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/port/list" }, "response": [ { "id": "95751819-4458-4c0c-8dc2-72be4f63678c", "name": "ListClusterPortsResponse contains the response to a list cluster [prts] request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"ports\": [\n {\n \"addon_guid\": \"\",\n \"addon_id\": \"\",\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"exposed_ports\": [\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n },\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n }\n ],\n \"hostname\": \"\",\n \"is_wildcard\": \"\",\n \"port_name\": \"\",\n \"state\": \"\",\n \"upstream_port\": \"\"\n },\n {\n \"addon_guid\": \"\",\n \"addon_id\": \"\",\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"exposed_ports\": [\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n },\n {\n \"exposed_port\": \"\",\n \"protocol\": \"\"\n }\n ],\n \"hostname\": \"\",\n \"is_wildcard\": \"\",\n \"port_name\": \"\",\n \"state\": \"\",\n \"upstream_port\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-95751819-4458-4c0c-8dc2-72be4f63678c" }, { "id": "f5ad6675-2234-4858-9a14-ddbcf92ec377", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-f5ad6675-2234-4858-9a14-ddbcf92ec377" }, { "id": "49a4aca2-4fa1-4b29-9445-3c7382fa62dc", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-49a4aca2-4fa1-4b29-9445-3c7382fa62dc" }, { "id": "21ac9b02-b184-46b1-9acd-06460bf10139", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-21ac9b02-b184-46b1-9acd-06460bf10139" }, { "id": "853b41c1-6431-4e08-b50e-8fedd3a16e05", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ports", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ports" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-853b41c1-6431-4e08-b50e-8fedd3a16e05" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-7a6eef4d-46ab-48f6-b53e-4285540f34a8" } ], "id": "6b17a7dc-ae7a-4ae0-a9cc-1842020d220f", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-6b17a7dc-ae7a-4ae0-a9cc-1842020d220f" }, { "name": "tags", "item": [ { "name": "Update the tags for a cluster.", "id": "10f0c5f9-3e13-4f70-9fb9-3bce802f1673", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "tags" ], "variable": [ { "id": "09889bad-95aa-44ba-8f7e-508bac1daf2e", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/tag/update" }, "response": [ { "id": "5efd079f-4d70-40dd-b928-6900ea1c7cae", "name": "UpdateClusterTagsResponse contains the response to update a cluster tags", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "tags" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-5efd079f-4d70-40dd-b928-6900ea1c7cae" }, { "id": "c1c7e12a-fb21-4d10-8264-24b94c1c3192", "name": "Return if the caller is not authorized", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "tags" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-c1c7e12a-fb21-4d10-8264-24b94c1c3192" }, { "id": "f17cb66c-71c7-4fd9-91c1-20379bbfe484", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "tags" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-f17cb66c-71c7-4fd9-91c1-20379bbfe484" }, { "id": "7a30643f-de5d-46f8-9b29-c813d3bb00a8", "name": "Returned on resource not found", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "tags" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-7a30643f-de5d-46f8-9b29-c813d3bb00a8" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-10f0c5f9-3e13-4f70-9fb9-3bce802f1673" } ], "id": "939cbef2-d39f-4045-944c-1333ff734963", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-939cbef2-d39f-4045-944c-1333ff734963" }, { "name": "ttl", "item": [ { "name": "Update ttl for a cluster.", "id": "8854e9ab-59cd-42cf-b9e3-6db42ad19c6e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "id": "5b647052-d4b0-44a0-b90a-f898aa2d11df", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/ttl/update" }, "response": [ { "id": "6be60b78-93b0-41c0-a25c-4aeb3c4874b9", "name": "UpdateClusterTTLResponse contains the response to update a cluster ttl", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-6be60b78-93b0-41c0-a25c-4aeb3c4874b9" }, { "id": "11234334-6339-40bd-8ccc-83c02de23094", "name": "UpdateClusterTTLErrorResponse contains error information", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-11234334-6339-40bd-8ccc-83c02de23094" }, { "id": "8d78c09e-6c91-432a-9b08-4eff0a9bc4ee", "name": "Return if the caller is not authorized", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-8d78c09e-6c91-432a-9b08-4eff0a9bc4ee" }, { "id": "446828ec-0d18-4996-8e5c-2467b1c023bc", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-446828ec-0d18-4996-8e5c-2467b1c023bc" }, { "id": "dedf9815-0c49-4fbf-9594-bb47782593be", "name": "Returned on resource not found", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/ttl", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "ttl" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-dedf9815-0c49-4fbf-9594-bb47782593be" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-8854e9ab-59cd-42cf-b9e3-6db42ad19c6e" } ], "id": "784553d5-3718-49d1-a9f9-633129f2256a", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-784553d5-3718-49d1-a9f9-633129f2256a" }, { "name": "upgrade", "item": [ { "name": "Upgrade a test cluster.", "id": "10d1a2fc-1266-4604-89c9-9e02ee1fb0a4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "id": "db0377f2-1961-495d-9109-31e70b68ec33", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/upgrade" }, "response": [ { "id": "afc954c5-e32a-45c5-bc16-c4c97b12f76a", "name": "UpgradeClusterResponse contains the response to upgrade a cluster", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-afc954c5-e32a-45c5-bc16-c4c97b12f76a" }, { "id": "a67b408d-1e84-467d-bde8-72a45640d310", "name": "UpgradeClusterValidationErrorResponse contains a bad request response when upgrading a cluster", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "key": "cluster_id" } ] } }, "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 \"supported_distributions\": [\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n },\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n }\n ]\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-a67b408d-1e84-467d-bde8-72a45640d310" }, { "id": "e60579fe-afb1-47e9-8381-2f0ae114674a", "name": "Return if the caller is not authorized", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-e60579fe-afb1-47e9-8381-2f0ae114674a" }, { "id": "b3eccd28-8f5a-4013-b965-8d25df32f7ce", "name": "Returned if the caller does not have the needed permission", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-b3eccd28-8f5a-4013-b965-8d25df32f7ce" }, { "id": "d6c36201-9bbf-4b42-bca9-1e0a622e8dbd", "name": "Returned on resource not found", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"kubernetes_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster/:cluster_id/upgrade?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id", "upgrade" ], "query": [ { "key": "DryRun", "value": "" } ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-d6c36201-9bbf-4b42-bca9-1e0a622e8dbd" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-10d1a2fc-1266-4604-89c9-9e02ee1fb0a4" } ], "id": "965d5c89-72f4-4638-9c22-cac436a70b83", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-965d5c89-72f4-4638-9c22-cac436a70b83" }, { "name": "Get the details for a test cluster.", "id": "eb0a1215-2bb6-4606-bbc2-20d57425e05e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "id": "073b53ed-0886-4220-b7ea-3af59bc8bba9", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]" }, "response": [ { "id": "2de09521-5f2a-421f-9a2c-90e43e13a449", "name": "GetClusterResponse contains the response to get cluster details", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-2de09521-5f2a-421f-9a2c-90e43e13a449" }, { "id": "1cb4e752-b6ca-4764-8cc8-22dff461fdf0", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-1cb4e752-b6ca-4764-8cc8-22dff461fdf0" }, { "id": "da502c3f-cb8c-4e0e-9c9d-d7da4fbb2b58", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-da502c3f-cb8c-4e0e-9c9d-d7da4fbb2b58" }, { "id": "bbb9c100-93b3-4f4e-aca1-4c93b7f5af8b", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-bbb9c100-93b3-4f4e-aca1-4c93b7f5af8b" }, { "id": "754903ee-986f-4766-b9b9-ec7306012776", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-754903ee-986f-4766-b9b9-ec7306012776" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-eb0a1215-2bb6-4606-bbc2-20d57425e05e" }, { "name": "Delete a test cluster.", "id": "9081444b-e3a5-4c13-bb1a-931856f803d7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "id": "23494efd-4c9f-4009-95d7-ce14eaa48ef6", "key": "cluster_id", "value": "", "description": "(Required) Cluster identifier" } ] }, "description": "Required RBAC Policy: kots/cluster/[:clusterid]/delete" }, "response": [ { "id": "6bd58ede-fc8c-4e03-a1f7-8babf0bff814", "name": "DeleteClusterResponse contains the response to delete a cluster", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-6bd58ede-fc8c-4e03-a1f7-8babf0bff814" }, { "id": "1ed2a353-cd85-4487-ada9-accd49b13053", "name": "Returned on bad input", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-1ed2a353-cd85-4487-ada9-accd49b13053" }, { "id": "427a9ea4-f583-4503-9304-8aeafa6677aa", "name": "Return if the caller is not authorized", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-427a9ea4-f583-4503-9304-8aeafa6677aa" }, { "id": "7a456fec-1061-497f-a7d7-5b5eec598993", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-7a456fec-1061-497f-a7d7-5b5eec598993" }, { "id": "039a9176-7d28-44ba-a20e-7d3993f12057", "name": "Returned on resource not found", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/cluster/:cluster_id", "host": [ "{{baseUrl}}" ], "path": [ "cluster", ":cluster_id" ], "variable": [ { "key": "cluster_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-039a9176-7d28-44ba-a20e-7d3993f12057" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-9081444b-e3a5-4c13-bb1a-931856f803d7" } ], "id": "bbbc4aa9-7635-4ecf-973b-7e11a84aec35", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-bbbc4aa9-7635-4ecf-973b-7e11a84aec35" }, { "name": "Create a test cluster.", "id": "3de255f3-d8fd-462b-8521-ac51c394d5f5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] }, "description": "Required RBAC Policy: kots/cluster/create" }, "response": [ { "id": "38dcd8a1-a78c-4876-9dc5-fa516c580fd8", "name": "CreateClusterDryRunResponse contains the response to a dry run of creating a cluster", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"maxAKS\": \"\",\n \"maxDiskGiB\": \"\",\n \"maxEKS\": \"\",\n \"maxGKE\": \"\",\n \"maxMemoryGiB\": \"\",\n \"maxOKE\": \"\",\n \"maxVCPUs\": \"\",\n \"message\": \"\",\n \"validationError\": {\n \"errors\": [\n \"\",\n \"\"\n ],\n \"supported_distributions\": [\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n },\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n },\n \"total_cost\": \"\",\n \"ttl\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-38dcd8a1-a78c-4876-9dc5-fa516c580fd8" }, { "id": "edc0f850-0d85-47f8-b790-cf2150c105a8", "name": "CreateClusterResponse contains the response to create a cluster", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"cluster\": {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-edc0f850-0d85-47f8-b790-cf2150c105a8" }, { "id": "b9e56faa-07f4-43ef-b2b7-eb410051942b", "name": "CreateClusterErrorResponse contains error information", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"maxAKS\": \"\",\n \"maxDiskGiB\": \"\",\n \"maxEKS\": \"\",\n \"maxGKE\": \"\",\n \"maxMemoryGiB\": \"\",\n \"maxOKE\": \"\",\n \"maxVCPUs\": \"\",\n \"message\": \"\",\n \"validationError\": {\n \"errors\": [\n \"\",\n \"\"\n ],\n \"supported_distributions\": [\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n },\n {\n \"instance_types\": [\n \"\",\n \"\"\n ],\n \"nodes_max\": \"\",\n \"short_name\": \"\",\n \"status\": {\n \"enabled\": \"\",\n \"status\": \"\",\n \"status_message\": \"\",\n \"versions\": \"\"\n },\n \"version_details\": [\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n },\n {\n \"nodes_max\": \"\",\n \"version\": \"\"\n }\n ],\n \"versions\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-b9e56faa-07f4-43ef-b2b7-eb410051942b" }, { "id": "bef26a6e-a54f-42ce-a216-61c8556b1043", "name": "Return if the caller is not authorized", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-bef26a6e-a54f-42ce-a216-61c8556b1043" }, { "id": "eb89e7f0-132a-4582-a641-6c8a29d9acc0", "name": "Returned if the caller does not have the needed permission", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-eb89e7f0-132a-4582-a641-6c8a29d9acc0" }, { "id": "6d215e2f-c706-4609-9f5e-b905d4d0414d", "name": "Returned on resource not found", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"additional_node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"default_node_group\": {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"license_id\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"network_policy\": \"\",\n \"node_count\": \"\",\n \"node_groups\": [\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n },\n {\n \"disk_gib\": \"\",\n \"instance_type\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"name\": \"\",\n \"node_count\": \"\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"ttl\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cluster?DryRun=", "host": [ "{{baseUrl}}" ], "path": [ "cluster" ], "query": [ { "key": "DryRun", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-6d215e2f-c706-4609-9f5e-b905d4d0414d" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-3de255f3-d8fd-462b-8521-ac51c394d5f5" } ], "id": "3ce0daf6-d621-49a8-b896-1cfddbb2acd9", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-3ce0daf6-d621-49a8-b896-1cfddbb2acd9" }, { "name": "clusters", "item": [ { "name": "List test clusters.", "id": "6e0119db-6893-4f7a-91a8-475f453fa7a4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] }, "description": "Required RBAC Policy: kots/cluster/list" }, "response": [ { "id": "b6e07b97-9964-4287-8826-ab0687cec9d5", "name": "ListClustersResponse contains the response to list clusters", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"clusters\": [\n {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n },\n {\n \"actor\": {\n \"description\": \"\",\n \"id\": \"\",\n \"link\": \"\",\n \"timestamp\": \"\",\n \"type\": \"\"\n },\n \"addons\": [\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"cluster_id\": \"\",\n \"created_at\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"object_store\": {\n \"bucket_name\": \"\",\n \"bucket_prefix\": \"\",\n \"service_account_name\": \"\",\n \"service_account_name_read_only\": \"\",\n \"service_account_namespace\": \"\"\n },\n \"port\": {\n \"is_wildcard\": \"\",\n \"name\": \"\",\n \"protocol_http\": \"\",\n \"protocol_https\": \"\",\n \"protocol_ws\": \"\",\n \"protocol_wss\": \"\",\n \"upstream_port\": \"\"\n },\n \"ready_at\": \"\",\n \"status\": \"\",\n \"terminated_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"assigned_at\": \"\",\n \"cluster_node\": {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n \"created_at\": \"\",\n \"credits_per_hour_per_cluster\": \"\",\n \"distribution\": \"\",\n \"expires_at\": \"\",\n \"flat_fee\": \"\",\n \"guid\": \"\",\n \"id\": \"\",\n \"installer_url\": \"\",\n \"ip_family\": \"\",\n \"kubernetes_distribution\": \"\",\n \"kubernetes_version\": \"\",\n \"last_scheduling_status\": \"\",\n \"license_id\": \"\",\n \"name\": \"\",\n \"network_id\": \"\",\n \"node_groups\": [\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n },\n {\n \"cluster_guid\": \"\",\n \"created_at\": \"\",\n \"credits_per_hour\": \"\",\n \"disk_gib\": \"\",\n \"id\": \"\",\n \"instance_type\": \"\",\n \"is_default\": \"\",\n \"max_node_count\": \"\",\n \"min_node_count\": \"\",\n \"minutes_billed\": \"\",\n \"name\": \"\",\n \"node_count\": \"\",\n \"nodes\": [\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n },\n {\n \"join_command\": \"\",\n \"network_id\": \"\",\n \"network_public_ips\": [\n \"\",\n \"\"\n ],\n \"node_group_id\": \"\",\n \"node_index\": \"\",\n \"node_type\": \"\",\n \"ssh_endpoint\": \"\",\n \"ssh_key\": \"\",\n \"ssh_port\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"total_credits\": \"\"\n }\n ],\n \"running_at\": \"\",\n \"status\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"team_id\": \"\",\n \"total_credits\": \"\",\n \"ttl\": \"\",\n \"version\": \"\"\n }\n ],\n \"error\": \"\",\n \"totalClusters\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-b6e07b97-9964-4287-8826-ab0687cec9d5" }, { "id": "e1236fff-ee49-496a-895f-161dc828ab1c", "name": "Returned on bad input", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-e1236fff-ee49-496a-895f-161dc828ab1c" }, { "id": "46789ebd-fa76-4df8-bf3f-d73513eb2c8c", "name": "Return if the caller is not authorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-46789ebd-fa76-4df8-bf3f-d73513eb2c8c" }, { "id": "1127f3a4-b5f0-4b4a-af89-57a307f118d0", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-1127f3a4-b5f0-4b4a-af89-57a307f118d0" }, { "id": "980c22b5-a6de-4364-83c4-6071224fda55", "name": "Returned on resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/clusters?pageSize=20¤tPage=&sortColumn=&sortDesc=&show-terminated=&start-time=&end-time=&actor-filter=&tag-filter=&tag-sort-key=", "host": [ "{{baseUrl}}" ], "path": [ "clusters" ], "query": [ { "description": "Page size", "key": "pageSize", "value": "20" }, { "description": "Current page", "key": "currentPage", "value": "" }, { "description": "Sort column", "key": "sortColumn", "value": "" }, { "description": "Sort descending", "key": "sortDesc", "value": "" }, { "key": "show-terminated", "value": "" }, { "description": "Specify a start time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "start-time", "value": "" }, { "description": "Specify an end time in the format \"YYYY-MM-DDTHH:MM:SSZ\".", "key": "end-time", "value": "" }, { "description": "Filter clusters by actor type or name, e.g. \"user\" or \"Replicated CLI\".", "key": "actor-filter", "value": "" }, { "description": "Filter clusters by tag, e.g. \"tag1=value1\".", "key": "tag-filter", "value": "" }, { "description": "Sort clusters by a specific key, e.g. \"terminated_at\" would sort by\ntermination time.", "key": "tag-sort-key", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-980c22b5-a6de-4364-83c4-6071224fda55" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-6e0119db-6893-4f7a-91a8-475f453fa7a4" } ], "id": "bfa27cc3-b7ad-4a28-9e67-bd79fbe1f957", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-bfa27cc3-b7ad-4a28-9e67-bd79fbe1f957" }, { "name": "cmx", "item": [ { "name": "credits", "item": [ { "name": "buy", "item": [ { "name": "Add credits to a team.", "id": "6ded68f3-57eb-4b9d-b061-cf20b3767760", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cmx/credits/buy", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "credits", "buy" ] }, "description": "Start the process of adding credits to a team. This generally\ncredits a stripe checkout session" }, "response": [ { "id": "eb9b2b30-8b42-46f5-a722-3b31b11034b7", "name": "IncreaseClusterCreditsResponse contains the response to increase cluster credits", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cmx/credits/buy", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "credits", "buy" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"checkout_url\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-eb9b2b30-8b42-46f5-a722-3b31b11034b7" }, { "id": "221adfdd-38c7-46c4-9e9f-bcb232bc59f7", "name": "IncreaseClusterCreditsErrorResponse contains the errors returned when increasing cluster credits", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cmx/credits/buy", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "credits", "buy" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-221adfdd-38c7-46c4-9e9f-bcb232bc59f7" }, { "id": "af3e16dd-c15f-427d-83b3-5b45c2d1028b", "name": "IncreaseClusterCreditsErrorResponse contains the errors returned when increasing cluster credits", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/cmx/credits/buy", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "credits", "buy" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-af3e16dd-c15f-427d-83b3-5b45c2d1028b" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-6ded68f3-57eb-4b9d-b061-cf20b3767760" } ], "id": "85c00dab-c008-4c37-a605-a2262ac87933", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-85c00dab-c008-4c37-a605-a2262ac87933" } ], "id": "32d4b275-aabf-4b38-aadc-b2abfc54d2c5", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-32d4b275-aabf-4b38-aadc-b2abfc54d2c5" }, { "name": "quotas", "item": [ { "name": "increase", "item": [ { "name": "Send a request to increase cluster quota.", "id": "b5dbc7b5-73f0-4bbd-a261-2ceb1abccef5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] }, "description": "Required RBAC Policy: kots/cluster/increase-quota" }, "response": [ { "id": "df2401bc-7b51-4be8-a285-4050c574855a", "name": "IncreaseClusterQuotaResponse contains the response to increase cluster quota", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-df2401bc-7b51-4be8-a285-4050c574855a" }, { "id": "85968b3c-1b28-4e0d-9649-51e675f699e6", "name": "IncreaseClusterQuotaErrorResponse contains the errors returned when increasing cluster quota", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-85968b3c-1b28-4e0d-9649-51e675f699e6" }, { "id": "86d970de-dd3e-465c-90da-7afc6fdf324c", "name": "Return if the caller is not authorized", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-86d970de-dd3e-465c-90da-7afc6fdf324c" }, { "id": "9ac2bfed-0519-4a9f-a2d5-1255033ed023", "name": "Returned if the caller does not have the needed permission", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"message\": \"\",\n \"messageCode\": \"\"\n }\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-9ac2bfed-0519-4a9f-a2d5-1255033ed023" }, { "id": "3bf5cc69-7334-4b67-a067-b6d3f0f2236e", "name": "Returned on resource not found", "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": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"requests\": [\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n },\n {\n \"name\": \"\",\n \"requested_value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/cmx/quotas/increase", "host": [ "{{baseUrl}}" ], "path": [ "cmx", "quotas", "increase" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\"\n}", "createdAt": "2026-07-28T02:45:15.000Z", "updatedAt": "2026-07-28T02:45:15.000Z", "uid": "35240-3bf5cc69-7334-4b67-a067-b6d3f0f2236e" } ], "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-b5dbc7b5-73f0-4bbd-a261-2ceb1abccef5" } ], "id": "2e00564b-3b6d-4248-9f5c-0ffacbe1d721", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-2e00564b-3b6d-4248-9f5c-0ffacbe1d721" } ], "id": "17184ab7-b901-4fa4-b9c7-c4a0d3c28748", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-17184ab7-b901-4fa4-b9c7-c4a0d3c28748" } ], "id": "8ca8caa6-8c3f-4f72-9288-cf94e5a2075c", "createdAt": "2026-07-28T02:45:14.000Z", "updatedAt": "2026-07-28T02:45:14.000Z", "uid": "35240-8ca8caa6-8c3f-4f72-9288-cf94e5a2075c" } ], "variable": [ { "key": "baseUrl", "value": "https://api.replicated.com/vendor/v3" } ] }