{ "info": { "_postman_id": "f2f093be-b31e-4ac9-a75e-3b4295c75c06", "name": "Vendor API V3 apps instances 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:31.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "lastUpdatedBy": "35240", "uid": "35240-f2f093be-b31e-4ac9-a75e-3b4295c75c06" }, "item": [ { "name": "app", "item": [ { "name": "{app_id}", "item": [ { "name": "customer", "item": [ { "name": "{customer_id}", "item": [ { "name": "instance", "item": [ { "name": "{instance_id}", "item": [ { "name": "running-images", "item": [ { "name": "Get running images for an instance.", "id": "80e26940-0d89-4143-897a-c42bc248faae", "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/customer/:customer_id/instance/:instance_id/running-images?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "running-images" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "id": "8e3626fc-6aa8-4ca1-8e84-39904fa16563", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "956a3453-f4e8-4945-ab0a-e78acafb9f63", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" }, { "id": "f41e5ee8-a201-4a7e-9047-0814abffba22", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Required RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "d80b9a28-f13c-47a5-9d3f-140e62a1f8a0", "name": "New Response", "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/customer/:customer_id/instance/:instance_id/running-images?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "running-images" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"running_images\": {\n \"quisa3\": [\n \"\",\n \"\"\n ],\n \"in_2\": [\n \"\",\n \"\"\n ],\n \"elit185\": [\n \"\",\n \"\"\n ]\n }\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-d80b9a28-f13c-47a5-9d3f-140e62a1f8a0" }, { "id": "71a85569-2730-40a1-acdd-7cfb21baa5d4", "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/customer/:customer_id/instance/:instance_id/running-images?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "running-images" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-71a85569-2730-40a1-acdd-7cfb21baa5d4" }, { "id": "48e08395-e451-4965-b858-be0e7176c9e2", "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/customer/:customer_id/instance/:instance_id/running-images?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "running-images" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-48e08395-e451-4965-b858-be0e7176c9e2" }, { "id": "06095bbf-ce52-4b05-8768-8f7f6afc5346", "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/customer/:customer_id/instance/:instance_id/running-images?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "running-images" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-06095bbf-ce52-4b05-8768-8f7f6afc5346" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-80e26940-0d89-4143-897a-c42bc248faae" } ], "id": "10d545d4-0d1b-453d-ac76-c709422d5020", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-10d545d4-0d1b-453d-ac76-c709422d5020" }, { "name": "scan", "item": [ { "name": "trigger", "item": [ { "name": "Trigger a security scan for an instance image.", "id": "5f18c2ff-9376-4301-9f27-a6266fa52d4f", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "id": "3aba652d-1167-49dd-9f04-a18aaeb80fe7", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "0903ac4b-b539-4eda-a26e-d9f413ea6697", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" }, { "id": "c6ac4f7d-fb21-48dd-9d2d-4632938f6a80", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Sends a request to SecureBuild to scan a specific image from a customer instance.\nThis is typically used when no SBOM exists for an image.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update" }, "response": [ { "id": "87b42163-c2ae-4a8a-8daa-a7c27169ca93", "name": "TriggerCustomerInstanceScanResponse contains the response for triggering a scan", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"success\": \"\"\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-87b42163-c2ae-4a8a-8daa-a7c27169ca93" }, { "id": "ee655608-e733-4952-bdcd-bc2a3d0376f8", "name": "Returned on bad input", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-ee655608-e733-4952-bdcd-bc2a3d0376f8" }, { "id": "e255561b-0225-422c-bc20-f8c8423a9706", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e255561b-0225-422c-bc20-f8c8423a9706" }, { "id": "608a4eb2-761e-45b3-a198-9426bb5e5c94", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-608a4eb2-761e-45b3-a198-9426bb5e5c94" }, { "id": "b57d609a-132c-4c1c-8f11-d17a3babea23", "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 \"image_name\": \"\",\n \"image_digest\": \"\",\n \"cluster_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/scan/trigger", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan", "trigger" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-b57d609a-132c-4c1c-8f11-d17a3babea23" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-5f18c2ff-9376-4301-9f27-a6266fa52d4f" } ], "id": "de66021f-8f67-46f5-a48f-f5dbe2233141", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-de66021f-8f67-46f5-a48f-f5dbe2233141" }, { "name": "Get security scan summaries for an instance.", "id": "93b4b01c-c25a-4dd6-ae72-596154ff1b61", "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/customer/:customer_id/instance/:instance_id/scan?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "id": "7cc15ab0-37e6-444d-ae00-2b5cdd88a364", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "13a934e7-ceda-42b7-a76e-6f0408f5974a", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" }, { "id": "92ded854-ca17-4739-945a-e0d44dbd4d2c", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Retrieve security scan summaries for all images reported by a specific instance.\nThe response contains scan summaries in the same shape as the channel-based endpoint.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "fe7c7312-860b-4d28-948b-b8e8bd836255", "name": "GetCustomerInstanceScanResponse contains the security scan summaries for the instance images.", "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/customer/:customer_id/instance/:instance_id/scan?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"scans\": [\n {\n \"digest\": \"\",\n \"digest_first_seen_at\": \"\",\n \"image_size_bytes\": \"\",\n \"input\": \"\",\n \"installation_phase\": \"\",\n \"last_scanned_at\": \"\",\n \"not_found\": \"\",\n \"result\": {\n \"counts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n },\n \"created_at\": \"\",\n \"critical\": {\n \"dolor_3\": \"\"\n },\n \"descriptor\": {\n \"name\": \"\",\n \"version\": \"\"\n },\n \"fixed_counts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n },\n \"high\": {\n \"sed_a6\": \"\",\n \"Ut_b67\": \"\",\n \"amet_9\": \"\"\n },\n \"low\": {\n \"consequat_de\": \"\",\n \"eu_f\": \"\",\n \"deserunt_5\": \"\"\n },\n \"medium\": {\n \"laborum_587\": \"\"\n },\n \"vulnerability_details\": [\n {\n \"artifact_name\": \"\",\n \"artifact_type\": \"\",\n \"artifact_version\": \"\",\n \"cve\": \"\",\n \"description\": \"\",\n \"epss_percentile\": \"\",\n \"fix_state\": \"\",\n \"fix_versions\": [\n \"\",\n \"\"\n ],\n \"risk\": \"\",\n \"severity\": \"\"\n },\n {\n \"artifact_name\": \"\",\n \"artifact_type\": \"\",\n \"artifact_version\": \"\",\n \"cve\": \"\",\n \"description\": \"\",\n \"epss_percentile\": \"\",\n \"fix_state\": \"\",\n \"fix_versions\": [\n \"\",\n \"\"\n ],\n \"risk\": \"\",\n \"severity\": \"\"\n }\n ]\n },\n \"sbom_status\": \"\",\n \"sbom_status_message\": \"\",\n \"sbom_status_updated_at\": \"\",\n \"scan_status\": \"\",\n \"scan_status_message\": \"\",\n \"scan_status_updated_at\": \"\",\n \"source_type\": \"\",\n \"sources\": [\n {\n \"chart_name\": \"\",\n \"is_installer_only\": \"\",\n \"resource_kind\": \"\",\n \"resource_name\": \"\",\n \"resource_namespace\": \"\"\n },\n {\n \"chart_name\": \"\",\n \"is_installer_only\": \"\",\n \"resource_kind\": \"\",\n \"resource_name\": \"\",\n \"resource_namespace\": \"\"\n }\n ]\n },\n {\n \"digest\": \"\",\n \"digest_first_seen_at\": \"\",\n \"image_size_bytes\": \"\",\n \"input\": \"\",\n \"installation_phase\": \"\",\n \"last_scanned_at\": \"\",\n \"not_found\": \"\",\n \"result\": {\n \"counts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n },\n \"created_at\": \"\",\n \"critical\": {\n \"eu118\": \"\",\n \"elit9\": \"\",\n \"id9\": \"\"\n },\n \"descriptor\": {\n \"name\": \"\",\n \"version\": \"\"\n },\n \"fixed_counts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n },\n \"high\": {\n \"qui_a6\": \"\"\n },\n \"low\": {\n \"enim_d6\": \"\",\n \"cupidatat70\": \"\"\n },\n \"medium\": {\n \"velit_61\": \"\",\n \"doloref\": \"\",\n \"eu67c\": \"\",\n \"magna_36\": \"\"\n },\n \"vulnerability_details\": [\n {\n \"artifact_name\": \"\",\n \"artifact_type\": \"\",\n \"artifact_version\": \"\",\n \"cve\": \"\",\n \"description\": \"\",\n \"epss_percentile\": \"\",\n \"fix_state\": \"\",\n \"fix_versions\": [\n \"\",\n \"\"\n ],\n \"risk\": \"\",\n \"severity\": \"\"\n },\n {\n \"artifact_name\": \"\",\n \"artifact_type\": \"\",\n \"artifact_version\": \"\",\n \"cve\": \"\",\n \"description\": \"\",\n \"epss_percentile\": \"\",\n \"fix_state\": \"\",\n \"fix_versions\": [\n \"\",\n \"\"\n ],\n \"risk\": \"\",\n \"severity\": \"\"\n }\n ]\n },\n \"sbom_status\": \"\",\n \"sbom_status_message\": \"\",\n \"sbom_status_updated_at\": \"\",\n \"scan_status\": \"\",\n \"scan_status_message\": \"\",\n \"scan_status_updated_at\": \"\",\n \"source_type\": \"\",\n \"sources\": [\n {\n \"chart_name\": \"\",\n \"is_installer_only\": \"\",\n \"resource_kind\": \"\",\n \"resource_name\": \"\",\n \"resource_namespace\": \"\"\n },\n {\n \"chart_name\": \"\",\n \"is_installer_only\": \"\",\n \"resource_kind\": \"\",\n \"resource_name\": \"\",\n \"resource_namespace\": \"\"\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-fe7c7312-860b-4d28-948b-b8e8bd836255" }, { "id": "f781765d-7166-4603-a875-e37fec2d0757", "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/customer/:customer_id/instance/:instance_id/scan?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-f781765d-7166-4603-a875-e37fec2d0757" }, { "id": "372af32b-718d-4d6a-9e85-eed3d6f74b54", "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/customer/:customer_id/instance/:instance_id/scan?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-372af32b-718d-4d6a-9e85-eed3d6f74b54" }, { "id": "3117c02f-84be-4965-8575-2f4abbcbc8fa", "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/customer/:customer_id/instance/:instance_id/scan?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "scan" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-3117c02f-84be-4965-8575-2f4abbcbc8fa" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-93b4b01c-c25a-4dd6-ae72-596154ff1b61" } ], "id": "e95906a8-19d8-4814-a29f-7142143a01a6", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e95906a8-19d8-4814-a29f-7142143a01a6" }, { "name": "tags", "item": [ { "name": "Get tags for a instance.", "id": "6d67a124-f0f0-4c8f-88e1-1f7f01db622f", "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/customer/:customer_id/instance/:instance_id/tags?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "id": "23564b0a-d408-49eb-bff8-dea6ee8402cc", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "afe23095-895f-484d-9d34-543a30319e73", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" }, { "id": "54fb28d2-b77b-472a-b5e7-ae4f2721f7bd", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Retrieve the tags associated with a specific customer instance, allowing teams to view metadata or categorization applied to that instance.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "988d32ac-3882-43d7-803d-84ac817fec20", "name": "GetCustomerInstanceTagsResponse contains the response to update a instance tags", "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/customer/:customer_id/instance/:instance_id/tags?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-988d32ac-3882-43d7-803d-84ac817fec20" }, { "id": "5780a054-498b-41b9-a717-88045aee6d9d", "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/customer/:customer_id/instance/:instance_id/tags?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-5780a054-498b-41b9-a717-88045aee6d9d" }, { "id": "7011bb9e-bd0f-496f-872b-74f3916851ef", "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/customer/:customer_id/instance/:instance_id/tags?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-7011bb9e-bd0f-496f-872b-74f3916851ef" }, { "id": "36f3aae7-7da3-475a-ad34-2807b02bb0e8", "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/customer/:customer_id/instance/:instance_id/tags?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-36f3aae7-7da3-475a-ad34-2807b02bb0e8" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-6d67a124-f0f0-4c8f-88e1-1f7f01db622f" }, { "name": "Create or update the tags for an instance.", "id": "d602a344-74ab-4dff-af3c-33010b81d262", "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 \"cluster_id\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "variable": [ { "id": "0ffc9daa-49dd-4bf7-8d41-3d138f34fdc5", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "6ff5a139-e0b5-4991-8f4a-b0f8d85ec870", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" }, { "id": "bfd9f671-e0d8-42c4-ab28-2abdd043be6f", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Create or update tags for a specific customer instance.\nTags can be used for categorization, filtering, or metadata. Keys with empty values will remove the tag.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update" }, "response": [ { "id": "666b9828-2fe2-4580-9dc7-515829ecb394", "name": "UpdateCustomerInstanceTagsResponse contains the response to update a instance 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 \"cluster_id\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"customerInstance\": {\n \"active\": \"\",\n \"appStatus\": \"\",\n \"client\": \"\",\n \"cloud\": \"\",\n \"clusterId\": \"\",\n \"createdAt\": \"\",\n \"embeddedClusterVersion\": \"\",\n \"instanceId\": \"\",\n \"isAirgap\": \"\",\n \"isArchived\": \"\",\n \"isDummyInstance\": \"\",\n \"isEmbeddedCluster\": \"\",\n \"isKurl\": \"\",\n \"k8sVersion\": \"\",\n \"kotsVersion\": \"\",\n \"kurlNodeCountReady\": \"\",\n \"kurlNodeCountTotal\": \"\",\n \"lastActive\": \"\",\n \"licenseId\": \"\",\n \"replicatedSdkVersion\": \"\",\n \"securitySummary\": {\n \"imageCount\": \"\",\n \"lastScannedAt\": \"\",\n \"vulnerabilityCounts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n }\n },\n \"serviceAccountId\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ],\n \"versionHistory\": [\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n }\n ]\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-666b9828-2fe2-4580-9dc7-515829ecb394" }, { "id": "35bc7e39-58a4-4d66-a61d-0790d0ed076d", "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 \"cluster_id\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-35bc7e39-58a4-4d66-a61d-0790d0ed076d" }, { "id": "3714c04c-38e8-4744-819d-f086e2d5e73a", "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 \"cluster_id\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-3714c04c-38e8-4744-819d-f086e2d5e73a" }, { "id": "1e1b7265-18b0-4827-8f98-453f46ed4e11", "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 \"cluster_id\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/customer/:customer_id/instance/:instance_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instance", ":instance_id", "tags" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" }, { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-1e1b7265-18b0-4827-8f98-453f46ed4e11" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-d602a344-74ab-4dff-af3c-33010b81d262" } ], "id": "882859b9-5a7f-408c-b09f-3234fdf840c5", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-882859b9-5a7f-408c-b09f-3234fdf840c5" } ], "id": "b8a5bfb9-8db4-445a-bbe9-bf2bb8984a9a", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-b8a5bfb9-8db4-445a-bbe9-bf2bb8984a9a" } ], "id": "e8eaa09d-9c0b-4f60-8b76-9954a1e2a91f", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e8eaa09d-9c0b-4f60-8b76-9954a1e2a91f" }, { "name": "instances", "item": [ { "name": "List customer instances.", "id": "985e8f90-4c97-4b3e-84d1-6800043e48a4", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "id": "f2a9e048-0fe7-4455-86ed-02885c667c23", "key": "app_id", "value": "", "description": "(Required) App identifier" }, { "id": "f6a9218f-d90b-4e07-99aa-269703818fe8", "key": "customer_id", "value": "", "description": "(Required) Customer identifier" } ] }, "description": "Return a list of all instances associated with a specific customer and app, including instance metadata and status.\nUseful for tracking deployments and usage per customer.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "c5f98a62-8cbf-46a6-af5c-83d4b438aab4", "name": "ListCustomerInstancesResponse contains the JSON instances list", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "key": "app_id" }, { "key": "customer_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"instances\": [\n {\n \"active\": \"\",\n \"appStatus\": \"\",\n \"client\": \"\",\n \"cloud\": \"\",\n \"clusterId\": \"\",\n \"createdAt\": \"\",\n \"embeddedClusterVersion\": \"\",\n \"instanceId\": \"\",\n \"isAirgap\": \"\",\n \"isArchived\": \"\",\n \"isDummyInstance\": \"\",\n \"isEmbeddedCluster\": \"\",\n \"isKurl\": \"\",\n \"k8sVersion\": \"\",\n \"kotsVersion\": \"\",\n \"kurlNodeCountReady\": \"\",\n \"kurlNodeCountTotal\": \"\",\n \"lastActive\": \"\",\n \"licenseId\": \"\",\n \"replicatedSdkVersion\": \"\",\n \"securitySummary\": {\n \"imageCount\": \"\",\n \"lastScannedAt\": \"\",\n \"vulnerabilityCounts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n }\n },\n \"serviceAccountId\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ],\n \"versionHistory\": [\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n }\n ]\n },\n {\n \"active\": \"\",\n \"appStatus\": \"\",\n \"client\": \"\",\n \"cloud\": \"\",\n \"clusterId\": \"\",\n \"createdAt\": \"\",\n \"embeddedClusterVersion\": \"\",\n \"instanceId\": \"\",\n \"isAirgap\": \"\",\n \"isArchived\": \"\",\n \"isDummyInstance\": \"\",\n \"isEmbeddedCluster\": \"\",\n \"isKurl\": \"\",\n \"k8sVersion\": \"\",\n \"kotsVersion\": \"\",\n \"kurlNodeCountReady\": \"\",\n \"kurlNodeCountTotal\": \"\",\n \"lastActive\": \"\",\n \"licenseId\": \"\",\n \"replicatedSdkVersion\": \"\",\n \"securitySummary\": {\n \"imageCount\": \"\",\n \"lastScannedAt\": \"\",\n \"vulnerabilityCounts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n }\n },\n \"serviceAccountId\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ],\n \"versionHistory\": [\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-c5f98a62-8cbf-46a6-af5c-83d4b438aab4" }, { "id": "9397c9ce-573b-4f63-ab65-ce4aceedb240", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "key": "app_id" }, { "key": "customer_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-9397c9ce-573b-4f63-ab65-ce4aceedb240" }, { "id": "e8d9a811-e538-48bc-aca2-4523ddf51c90", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "key": "app_id" }, { "key": "customer_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e8d9a811-e538-48bc-aca2-4523ddf51c90" }, { "id": "c55fde82-2bdd-441a-80bf-315d720d0d64", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "key": "app_id" }, { "key": "customer_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-c55fde82-2bdd-441a-80bf-315d720d0d64" }, { "id": "4507479a-24b7-446f-8eaa-17481f080644", "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/customer/:customer_id/instances", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "customer", ":customer_id", "instances" ], "variable": [ { "key": "app_id" }, { "key": "customer_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-4507479a-24b7-446f-8eaa-17481f080644" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-985e8f90-4c97-4b3e-84d1-6800043e48a4" } ], "id": "2e47ad4c-bbea-4077-b140-671022e45b81", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-2e47ad4c-bbea-4077-b140-671022e45b81" } ], "id": "8e370a6d-c8bf-4149-807e-2fabd2f37d49", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-8e370a6d-c8bf-4149-807e-2fabd2f37d49" } ], "id": "4d96505d-4f96-43e8-aaf7-51271fcecb58", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-4d96505d-4f96-43e8-aaf7-51271fcecb58" }, { "name": "instance-tag-schema", "item": [ { "name": "Get the instance tag schema for an app.", "id": "f44c287a-a28d-4a3c-9d87-7e49231afe29", "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/instance-tag-schema", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tag-schema" ], "variable": [ { "id": "f24bc2f1-37b2-49ba-aa29-70e2746147a1", "key": "app_id", "value": "", "description": "(Required) App identifier" } ] }, "description": "Returns a map of distinct tag keys to their distinct values across all instances belonging to the app.\n\nRequired RBAC Policy: kots/app/[:appid]/read" }, "response": [ { "id": "091b57af-609f-42b0-bee1-30931a4d8968", "name": "GetInstanceTagSchemaResponse contains the tag schema response", "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/instance-tag-schema", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tag-schema" ], "variable": [ { "key": "app_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"tags\": {\n \"mollit5\": [\n \"\",\n \"\"\n ],\n \"voluptate_5_6\": [\n \"\",\n \"\"\n ],\n \"indf5\": [\n \"\",\n \"\"\n ]\n }\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-091b57af-609f-42b0-bee1-30931a4d8968" }, { "id": "e7ec0cc2-9722-4444-9609-f1a609057c6b", "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/instance-tag-schema", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tag-schema" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e7ec0cc2-9722-4444-9609-f1a609057c6b" }, { "id": "36be25ac-2d3e-4b1a-a7ce-98723e3963d2", "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/instance-tag-schema", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tag-schema" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-36be25ac-2d3e-4b1a-a7ce-98723e3963d2" }, { "id": "d46ae4a6-ce02-4c5c-a7da-7d6d7348b84b", "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/instance-tag-schema", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tag-schema" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-d46ae4a6-ce02-4c5c-a7da-7d6d7348b84b" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-f44c287a-a28d-4a3c-9d87-7e49231afe29" } ], "id": "2dd8ae72-2e10-41a3-a352-08d645055d2d", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-2dd8ae72-2e10-41a3-a352-08d645055d2d" }, { "name": "instance-tags", "item": [ { "name": "Get tags for multiple instances.", "id": "77674dd7-49ec-4604-9b9f-7b3cf8dd7d6d", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "variable": [ { "id": "28b61163-d6b1-4210-92ff-5872c7c8a24f", "key": "app_id", "value": "", "description": "(Required) App identifier" } ] }, "description": "Accepts a list of instance IDs and returns their tags in a single response.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read" }, "response": [ { "id": "3cc839e9-434b-44a1-8991-629ed9de90bd", "name": "GetCustomerInstancesTagsBulkResponse contains the bulk tags response", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "variable": [ { "key": "app_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"results\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"tags\": [\n {\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-3cc839e9-434b-44a1-8991-629ed9de90bd" }, { "id": "35abe311-79f6-429b-8106-046f903612c3", "name": "Returned on bad input", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-35abe311-79f6-429b-8106-046f903612c3" }, { "id": "15a9f942-2fff-4a0f-8603-d9878d75a7c3", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-15a9f942-2fff-4a0f-8603-d9878d75a7c3" }, { "id": "e888c1e4-64c8-4d8f-a66a-90da43046992", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e888c1e4-64c8-4d8f-a66a-90da43046992" }, { "id": "2aafadae-3c40-4ad2-9967-daeca08b80f5", "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 \"clusterIds\": [\n \"\",\n \"\"\n ],\n \"instanceIds\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instance-tags", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instance-tags" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-2aafadae-3c40-4ad2-9967-daeca08b80f5" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-77674dd7-49ec-4604-9b9f-7b3cf8dd7d6d" } ], "id": "3792c410-2de4-4833-ad7e-46e56b9a9a22", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-3792c410-2de4-4833-ad7e-46e56b9a9a22" }, { "name": "instances", "item": [ { "name": "archive", "item": [ { "name": "Batch archive customer instances.", "id": "40d827c1-8c17-4179-8906-e4a597f0ed5f", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "variable": [ { "id": "bfc37fd7-755f-4e99-9995-507506f04a57", "key": "app_id", "value": "", "description": "(Required) App identifier" } ] }, "description": "Archives multiple customer instances in a single request. Only development,\nairgap, or inactive instances are eligible. Instances that cannot be archived\n(e.g., active production instances or instances the caller lacks permission\nfor) are skipped and returned in the skipped array with a reason.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update" }, "response": [ { "id": "40bc537b-15f8-4f85-99c7-03bb182bee3e", "name": "BatchArchiveCustomerInstancesResponse contains the bulk archive response.", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "variable": [ { "key": "app_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"archived\": \"\",\n \"error\": \"\",\n \"skipped\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\",\n \"reason\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\",\n \"reason\": \"\"\n }\n ],\n \"total\": \"\"\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-40bc537b-15f8-4f85-99c7-03bb182bee3e" }, { "id": "37fdc5d7-511f-4094-9e42-4cdb5d58e356", "name": "Returned on bad input", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-37fdc5d7-511f-4094-9e42-4cdb5d58e356" }, { "id": "4bcaaf86-e0be-4188-929d-01808a4e572e", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-4bcaaf86-e0be-4188-929d-01808a4e572e" }, { "id": "e313c0c0-2b4d-4554-8115-5c480e5ecc0f", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e313c0c0-2b4d-4554-8115-5c480e5ecc0f" }, { "id": "4aa06f32-55c4-4df3-8776-eb4d11d06c70", "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 \"instances\": [\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"instanceId\": \"\",\n \"licenseId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/app/:app_id/instances/archive", "host": [ "{{baseUrl}}" ], "path": [ "app", ":app_id", "instances", "archive" ], "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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-4aa06f32-55c4-4df3-8776-eb4d11d06c70" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-40d827c1-8c17-4179-8906-e4a597f0ed5f" } ], "id": "c8fcb5fc-90b1-4716-8cb4-8686bee41cef", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-c8fcb5fc-90b1-4716-8cb4-8686bee41cef" } ], "id": "e0f1d1fe-a121-4ac1-9365-c624b9da056e", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e0f1d1fe-a121-4ac1-9365-c624b9da056e" } ], "id": "26ab16e6-3875-47f7-bf60-18ef94774a48", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-26ab16e6-3875-47f7-bf60-18ef94774a48" } ], "id": "af07dace-e9b9-4cb6-bdb1-d84ce1e45ecc", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-af07dace-e9b9-4cb6-bdb1-d84ce1e45ecc" }, { "name": "instance", "item": [ { "name": "{instance_id}", "item": [ { "name": "archive", "item": [ { "name": "Archive an instance.", "id": "aba3d930-1ab4-4173-b0a4-b7cb22e803e6", "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": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/archive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "archive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "id": "5ca3c3b2-72c9-48d5-8f48-b3690af6d8d7", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Deactivate a customer instance, making it inactive and unavailable for future use.\nOnly development, airgap, or inactive instances can be archived.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update" }, "response": [ { "id": "fb155c61-14f9-4a05-ae20-7f76c025f308", "name": "ArchiveCustomerInstanceResponse contains the response to archive an instance", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/archive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "archive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"customerInstance\": {\n \"active\": \"\",\n \"appStatus\": \"\",\n \"client\": \"\",\n \"cloud\": \"\",\n \"clusterId\": \"\",\n \"createdAt\": \"\",\n \"embeddedClusterVersion\": \"\",\n \"instanceId\": \"\",\n \"isAirgap\": \"\",\n \"isArchived\": \"\",\n \"isDummyInstance\": \"\",\n \"isEmbeddedCluster\": \"\",\n \"isKurl\": \"\",\n \"k8sVersion\": \"\",\n \"kotsVersion\": \"\",\n \"kurlNodeCountReady\": \"\",\n \"kurlNodeCountTotal\": \"\",\n \"lastActive\": \"\",\n \"licenseId\": \"\",\n \"replicatedSdkVersion\": \"\",\n \"securitySummary\": {\n \"imageCount\": \"\",\n \"lastScannedAt\": \"\",\n \"vulnerabilityCounts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n }\n },\n \"serviceAccountId\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ],\n \"versionHistory\": [\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n }\n ]\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-fb155c61-14f9-4a05-ae20-7f76c025f308" }, { "id": "89e16d6b-d7d9-4e0a-8c74-6c68f8df7773", "name": "Return if the caller is not authorized", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/archive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "archive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-89e16d6b-d7d9-4e0a-8c74-6c68f8df7773" }, { "id": "aa0dce3c-9084-453f-bcab-adb2e1006d82", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/archive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "archive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-aa0dce3c-9084-453f-bcab-adb2e1006d82" }, { "id": "08fd3381-b318-4faf-8634-1ff524e89c92", "name": "Returned on resource not found", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/archive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "archive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-08fd3381-b318-4faf-8634-1ff524e89c92" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-aba3d930-1ab4-4173-b0a4-b7cb22e803e6" } ], "id": "3aa39b9e-25cc-4c2c-8fec-b42212f9e952", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-3aa39b9e-25cc-4c2c-8fec-b42212f9e952" }, { "name": "unarchive", "item": [ { "name": "Unarchive an instance.", "id": "9842d381-8400-4e72-a3e5-4e60c8385124", "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": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/unarchive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "unarchive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "id": "37dff99f-c943-451d-a7f3-d84ae8fed6f6", "key": "instance_id", "value": "", "description": "(Required) Instance identifier" } ] }, "description": "Restore a previously archived customer instance, making it active and available for use again.\n\nRequired RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update" }, "response": [ { "id": "7d8269ce-0d4e-495c-bedb-5ba79de46eb4", "name": "UnarchiveCustomerInstanceResponse contains the response to unarchive an instance", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/unarchive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "unarchive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"customerInstance\": {\n \"active\": \"\",\n \"appStatus\": \"\",\n \"client\": \"\",\n \"cloud\": \"\",\n \"clusterId\": \"\",\n \"createdAt\": \"\",\n \"embeddedClusterVersion\": \"\",\n \"instanceId\": \"\",\n \"isAirgap\": \"\",\n \"isArchived\": \"\",\n \"isDummyInstance\": \"\",\n \"isEmbeddedCluster\": \"\",\n \"isKurl\": \"\",\n \"k8sVersion\": \"\",\n \"kotsVersion\": \"\",\n \"kurlNodeCountReady\": \"\",\n \"kurlNodeCountTotal\": \"\",\n \"lastActive\": \"\",\n \"licenseId\": \"\",\n \"replicatedSdkVersion\": \"\",\n \"securitySummary\": {\n \"imageCount\": \"\",\n \"lastScannedAt\": \"\",\n \"vulnerabilityCounts\": {\n \"critical\": \"\",\n \"high\": \"\",\n \"low\": \"\",\n \"medium\": \"\",\n \"total\": \"\"\n }\n },\n \"serviceAccountId\": \"\",\n \"tags\": [\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n },\n {\n \"instanceId\": \"\",\n \"key\": \"\",\n \"origin\": \"\",\n \"value\": \"\"\n }\n ],\n \"versionHistory\": [\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n },\n {\n \"clusterId\": \"\",\n \"downstreamChannelId\": \"\",\n \"downstreamReleaseSequence\": \"\",\n \"instanceId\": \"\",\n \"intervalLast\": \"\",\n \"intervalStart\": \"\",\n \"nativeHelmCount\": \"\",\n \"replHelmCount\": \"\",\n \"versionLabel\": \"\"\n }\n ]\n },\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-7d8269ce-0d4e-495c-bedb-5ba79de46eb4" }, { "id": "558d85b2-48d7-4306-aaf3-8341c8e0fe60", "name": "Return if the caller is not authorized", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/unarchive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "unarchive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-558d85b2-48d7-4306-aaf3-8341c8e0fe60" }, { "id": "df88aa88-9962-43f7-bb57-ffdc30b8af69", "name": "Returned if the caller does not have the needed permission", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/unarchive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "unarchive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-df88aa88-9962-43f7-bb57-ffdc30b8af69" }, { "id": "e687b46c-24c7-4c28-8eb1-e822339a124b", "name": "Returned on resource not found", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/instance/:instance_id/unarchive?ClusterID=", "host": [ "{{baseUrl}}" ], "path": [ "instance", ":instance_id", "unarchive" ], "query": [ { "description": "Optional cluster identifier to disambiguate instance_id", "key": "ClusterID", "value": "" } ], "variable": [ { "key": "instance_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:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-e687b46c-24c7-4c28-8eb1-e822339a124b" } ], "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-9842d381-8400-4e72-a3e5-4e60c8385124" } ], "id": "a156d3a9-240b-4363-b718-7b492ea329c8", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-a156d3a9-240b-4363-b718-7b492ea329c8" } ], "id": "a6f46c02-8b0a-46d1-b370-16e443b4c9f8", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-a6f46c02-8b0a-46d1-b370-16e443b4c9f8" } ], "id": "90d42ccb-6035-4319-bcb9-f63c7e256599", "createdAt": "2026-07-28T02:45:32.000Z", "updatedAt": "2026-07-28T02:45:32.000Z", "uid": "35240-90d42ccb-6035-4319-bcb9-f63c7e256599" } ], "variable": [ { "key": "baseUrl", "value": "https://api.replicated.com/vendor/v3" } ] }