{ "info": { "_postman_id": "e5185652-4c26-4b93-b428-ae92a22b0772", "name": "Runloop Devbox API", "description": "Create, manage, and interact with Devboxes \u2014 isolated Linux sandbox environments for AI coding agents. Supports lifecycle (create/snapshot/suspend/resume/shutdown), shell execution, file I/O, networking (tunnels, port forwarding), PTY sessions, and observability (logs, metrics, executions).\n\nContact Support:\n Name: Runloop AI Support\n Email: support@runloop.ai", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:15:13.000Z", "updatedAt": "2026-06-05T15:15:13.000Z", "lastUpdatedBy": "35240", "uid": "35240-e5185652-4c26-4b93-b428-ae92a22b0772" }, "item": [ { "name": "pty", "item": [ { "name": "{session_name}", "item": [ { "name": "control", "item": [ { "name": "Send a control command to a PTY session.", "id": "fb54c9e9-f2dd-49b0-b76c-c01d8dcd2e33", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"action\": \"close\",\n \"cols\": \"\",\n \"rows\": \"\",\n \"signal\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/pty/:session_name/control", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name", "control" ], "variable": [ { "id": "833983bd-b4b2-4d5f-9903-a2277627fcee", "key": "session_name", "value": "", "description": "(Required) The client-chosen PTY session name. Must be 1..=256 ASCII letters, digits, '-' and '_'." } ] }, "description": "Applies a PTY control operation to an existing session. The action field selects the operation; the other fields in PtyControlParameters are interpreted only when they are relevant to the chosen action.\n\nresize: cols and rows are required and must each be in 1..=1000. A 0 or out-of-range value returns 400. The new winsize is applied to the PTY master and the kernel delivers SIGWINCH to the foreground process group.\n\nsignal: signal is the POSIX signal name (for example 'SIGTERM', 'SIGHUP', 'SIGINT', 'SIGUSR1'). Unknown signal names return 400. The signal is delivered to the slave's foreground process group via killpg(2). If the shell has already exited and there is no foreground process group, returns 400.\n\nclose: terminates the session. Sends SIGHUP to the foreground process group (best-effort; ignored if the shell has already exited) and drops the session from the server's session cache. A subsequent connect with the same session_name will create a fresh PTY session.\n\nDocumentation note: this operation is published from mux strictly as an OpenAPI contract stub for the PTY service control plane. It is not evidence that mux itself serves the interactive PTY transport." }, "response": [ { "id": "943dbf3a-281d-4a84-913d-7425cb2483b4", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"action\": \"close\",\n \"cols\": \"\",\n \"rows\": \"\",\n \"signal\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/pty/:session_name/control", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name", "control" ], "variable": [ { "key": "session_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"session_name\": \"\",\n \"status\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-943dbf3a-281d-4a84-913d-7425cb2483b4" }, { "id": "5f88b2b1-c414-4a71-90c0-404d04df18c4", "name": "Invalid action parameters: out-of-range cols/rows on resize, unknown signal name on signal, or no foreground process group on signal.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"action\": \"close\",\n \"cols\": \"\",\n \"rows\": \"\",\n \"signal\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/pty/:session_name/control", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name", "control" ], "variable": [ { "key": "session_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5f88b2b1-c414-4a71-90c0-404d04df18c4" }, { "id": "0aa0ab30-4b32-4f0b-a9b3-0614ab2b091a", "name": "PTY session not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"action\": \"close\",\n \"cols\": \"\",\n \"rows\": \"\",\n \"signal\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/pty/:session_name/control", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name", "control" ], "variable": [ { "key": "session_name" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-0aa0ab30-4b32-4f0b-a9b3-0614ab2b091a" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-fb54c9e9-f2dd-49b0-b76c-c01d8dcd2e33" } ], "id": "66ad6888-ecda-4b21-a379-cccc3da5ea9c", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-66ad6888-ecda-4b21-a379-cccc3da5ea9c" }, { "name": "Create or reconnect to a PTY session.", "id": "8a9d11b5-404a-4101-a634-941bb4803c3a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/pty/:session_name?cols=&rows=", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name" ], "query": [ { "description": "Optional initial terminal width in character cells (1..=1000). Defaults to 80 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "cols", "value": "" }, { "description": "Optional initial terminal height in character cells (1..=1000). Defaults to 24 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "rows", "value": "" } ], "variable": [ { "id": "bde8ecce-219d-41cf-aa77-fce5bb12733e", "key": "session_name", "value": "", "description": "(Required) The client-chosen PTY session name. Must be 1..=256 ASCII letters, digits, '-' and '_'. Reusing the same name reconnects to the same logical PTY session when it is still available." } ] }, "description": "Looks up the PTY session identified by the path session_name and either reconnects to the existing session or creates it if it does not yet exist. The session_name is a client-chosen session identifier, not an opaque server-issued ID. It must be non-empty (1..=256 chars) and use only ASCII letters, digits, '-' and '_'. A newly created PTY session starts an interactive bash shell on the Devbox. Optional cols and rows query parameters apply an initial terminal size before any I/O; they must both be present and in the range 1..=1000 to take effect. The response returns a PtyConnectView containing connect_url (a server-relative path to the WebSocket data plane), idle_ttl_seconds (how long this session is retained after the last client disconnects), and the resulting cols/rows. The interactive byte stream itself is intentionally not modeled in OpenAPI; see the controller-level documentation for the WebSocket close-code conventions. The single-attach contract is enforced when a client opens the WebSocket data plane, not on this bootstrap call: bootstrap always succeeds for a valid session_name, even if another client is currently attached. Rejection of a second concurrent attach happens at WebSocket upgrade time. If the active client disconnects, the session is preserved for the idle TTL so a later connect using the same session_name resumes the same shell. After the TTL expires, after an explicit close control action, or after the underlying Devbox lifecycle replaces the PTY process (such as through suspend/resume), a later request with the same session_name creates a fresh PTY session without the previous shell state.\n\nDocumentation note: this operation is published from mux strictly as an OpenAPI contract stub for the PTY service control plane. It is not evidence that mux itself serves the interactive PTY transport." }, "response": [ { "id": "d1173ca7-72d2-4dc6-afeb-57ba53c61962", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/pty/:session_name?cols=&rows=", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name" ], "query": [ { "description": "Optional initial terminal width in character cells (1..=1000). Defaults to 80 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "cols", "value": "" }, { "description": "Optional initial terminal height in character cells (1..=1000). Defaults to 24 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "rows", "value": "" } ], "variable": [ { "key": "session_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"created\": \"\",\n \"attached\": \"\",\n \"session_name\": \"\",\n \"status\": \"\",\n \"protocol_version\": \"\",\n \"connect_url\": \"\",\n \"cols\": \"\",\n \"rows\": \"\",\n \"idle_ttl_seconds\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d1173ca7-72d2-4dc6-afeb-57ba53c61962" }, { "id": "4a5e2573-ceff-4ca5-ac8e-ceffeafa9e00", "name": "Malformed session_name (alphabet or length out of range).", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/pty/:session_name?cols=&rows=", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name" ], "query": [ { "description": "Optional initial terminal width in character cells (1..=1000). Defaults to 80 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "cols", "value": "" }, { "description": "Optional initial terminal height in character cells (1..=1000). Defaults to 24 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "rows", "value": "" } ], "variable": [ { "key": "session_name" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-4a5e2573-ceff-4ca5-ac8e-ceffeafa9e00" }, { "id": "d44899d4-fcac-4016-97d6-31bde6c3f53b", "name": "PTY session could not be spawned (host resource exhaustion).", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/pty/:session_name?cols=&rows=", "host": [ "{{baseUrl}}" ], "path": [ "pty", ":session_name" ], "query": [ { "description": "Optional initial terminal width in character cells (1..=1000). Defaults to 80 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "cols", "value": "" }, { "description": "Optional initial terminal height in character cells (1..=1000). Defaults to 24 when omitted. Applied only if both cols and rows are provided; otherwise ignored.", "key": "rows", "value": "" } ], "variable": [ { "key": "session_name" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d44899d4-fcac-4016-97d6-31bde6c3f53b" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8a9d11b5-404a-4101-a634-941bb4803c3a" } ], "id": "8667a106-97d0-4a16-9cb2-0cc2b4ba7d26", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8667a106-97d0-4a16-9cb2-0cc2b4ba7d26" } ], "id": "f502a5fc-3a0f-4a2a-b47c-f94da6d838f6", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f502a5fc-3a0f-4a2a-b47c-f94da6d838f6" }, { "name": "v1", "item": [ { "name": "devboxes", "item": [ { "name": "disk_snapshots", "item": [ { "name": "list_public", "item": [ { "name": "List public disk snapshots.", "id": "c6a128c4-9572-41bb-ac7e-b4c1b067725c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/list_public?devbox_id=&source_blueprint_id=&metadata[key]=&metadata[key][in]=&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "list_public" ], "query": [ { "description": "Devbox ID to filter by.", "key": "devbox_id", "value": "" }, { "description": "Source Blueprint ID to filter snapshots by.", "key": "source_blueprint_id", "value": "" }, { "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys.", "key": "metadata[key]", "value": "" }, { "description": "Filter snapshots by metadata key with multiple possible values (OR condition).", "key": "metadata[key][in]", "value": "" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] }, "description": "List all public disk snapshots that are available to all users." }, "response": [ { "id": "723c932f-eaf9-4f1e-b661-0a9ba97f4e73", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/list_public?devbox_id=&source_blueprint_id=&metadata[key]=&metadata[key][in]=&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "list_public" ], "query": [ { "description": "Devbox ID to filter by.", "key": "devbox_id", "value": "" }, { "description": "Source Blueprint ID to filter snapshots by.", "key": "source_blueprint_id", "value": "" }, { "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys.", "key": "metadata[key]", "value": "" }, { "description": "Filter snapshots by metadata key with multiple possible values (OR condition).", "key": "metadata[key][in]", "value": "" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"snapshots\": [\n {\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"fugiat_980\": \"\",\n \"occaecat_908\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n },\n {\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"Duis_0d5\": \"\",\n \"culpa607\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n }\n ],\n \"has_more\": \"\",\n \"total_count\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-723c932f-eaf9-4f1e-b661-0a9ba97f4e73" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c6a128c4-9572-41bb-ac7e-b4c1b067725c" } ], "id": "0fd4aaa4-5dbe-41d3-bf5c-0871aa7c65b9", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-0fd4aaa4-5dbe-41d3-bf5c-0871aa7c65b9" }, { "name": "metadata", "item": [ { "name": "keys", "item": [ { "name": "{key}", "item": [ { "name": "values", "item": [ { "name": "List values for a specific snapshot metadata key.", "id": "e651dfcd-c5a9-4593-b6eb-92b023a07e22", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "metadata", "keys", ":key", "values" ], "variable": [ { "id": "dec434ee-9030-43fb-8eee-7a9a0b5a0141", "key": "key", "value": "", "description": "(Required) The metadata key to get values for." } ] }, "description": "Returns a list of all values that exist for a specific metadata key across all snapshots." }, "response": [ { "id": "5f4f58df-ba23-41e5-b7f3-a106c3ebe5b8", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5f4f58df-ba23-41e5-b7f3-a106c3ebe5b8" }, { "id": "6f6d668c-004b-41ef-96bc-9bf984a97a15", "name": "Invalid metadata key provided.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6f6d668c-004b-41ef-96bc-9bf984a97a15" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-e651dfcd-c5a9-4593-b6eb-92b023a07e22" } ], "id": "86dddd7b-e3fa-46d9-8de7-1ce54c6fa666", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-86dddd7b-e3fa-46d9-8de7-1ce54c6fa666" } ], "id": "373f835e-be0a-484e-a946-2a08f43b8a08", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-373f835e-be0a-484e-a946-2a08f43b8a08" }, { "name": "List available snapshot metadata keys.", "id": "cb371fd0-90ea-49e7-8a19-50a045937831", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "metadata", "keys" ] }, "description": "Returns a list of all available metadata keys that can be used for filtering snapshots." }, "response": [ { "id": "a362f184-ad46-4e9b-bc38-aa0e8f25aa96", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "metadata", "keys" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"keys\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a362f184-ad46-4e9b-bc38-aa0e8f25aa96" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-cb371fd0-90ea-49e7-8a19-50a045937831" } ], "id": "d941fe46-6052-4765-8710-9cbf074692f3", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d941fe46-6052-4765-8710-9cbf074692f3" } ], "id": "5a363a67-3d99-4a54-9e87-da7c4280ae16", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5a363a67-3d99-4a54-9e87-da7c4280ae16" }, { "name": "public", "item": [ { "name": "metadata", "item": [ { "name": "keys", "item": [ { "name": "{key}", "item": [ { "name": "values", "item": [ { "name": "List values for a specific public snapshot metadata key.", "id": "e14a2a14-510c-4238-a1df-23887e890645", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/public/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "public", "metadata", "keys", ":key", "values" ], "variable": [ { "id": "f7bcd339-ecac-4a0f-b466-b3b013236e7c", "key": "key", "value": "", "description": "(Required) The metadata key to get values for from public snapshots." } ] }, "description": "Returns a list of all values that exist for a specific metadata key across all public snapshots only." }, "response": [ { "id": "e02736ff-243b-4778-af7f-2c2b7ff42316", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/public/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "public", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-e02736ff-243b-4778-af7f-2c2b7ff42316" }, { "id": "114778f2-e2d5-4503-9c63-e175b6ab85b9", "name": "Invalid metadata key provided.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/public/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "public", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-114778f2-e2d5-4503-9c63-e175b6ab85b9" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-e14a2a14-510c-4238-a1df-23887e890645" } ], "id": "079d8afd-f6e3-4b54-ade5-a3173e771697", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-079d8afd-f6e3-4b54-ade5-a3173e771697" } ], "id": "58c608ca-26fc-46c6-912c-125c328d0695", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-58c608ca-26fc-46c6-912c-125c328d0695" }, { "name": "List available public snapshot metadata keys.", "id": "a754bc78-359c-465f-84d5-37e7cca91592", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/public/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "public", "metadata", "keys" ] }, "description": "Returns a list of all available metadata keys from public snapshots only that can be used for filtering." }, "response": [ { "id": "c8020980-1d01-45ac-8ed0-d15eeca8905c", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/public/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", "public", "metadata", "keys" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"keys\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c8020980-1d01-45ac-8ed0-d15eeca8905c" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a754bc78-359c-465f-84d5-37e7cca91592" } ], "id": "d9e6a256-7fe5-4788-9812-6b442f241b7c", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d9e6a256-7fe5-4788-9812-6b442f241b7c" } ], "id": "d4b73502-a443-4350-b88e-ce80c630b8df", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d4b73502-a443-4350-b88e-ce80c630b8df" } ], "id": "c23b2c8d-9acf-4a82-964d-b86e42d15d3d", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c23b2c8d-9acf-4a82-964d-b86e42d15d3d" }, { "name": "{id}", "item": [ { "name": "delete", "item": [ { "name": "Delete a disk snapshot of a Devbox.", "id": "a7b6c359-27cf-45e8-a530-ceaaaa7e2ca8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "delete" ], "variable": [ { "id": "28859615-8a85-4467-98fc-118f093b3f73", "key": "id", "value": "", "description": "(Required) The ID of the snapshot." } ] }, "description": "Delete a previously taken disk snapshot of a Devbox." }, "response": [ { "id": "507a6bf5-bb60-4ad3-b015-1209047efc10", "name": "Snapshot deleted successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "delete" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-507a6bf5-bb60-4ad3-b015-1209047efc10" }, { "id": "b2f51d4e-5abe-4ddf-8124-cef8dcf5bb31", "name": "Snapshot not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "delete" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b2f51d4e-5abe-4ddf-8124-cef8dcf5bb31" }, { "id": "8f893331-4706-4bc9-84e1-237763eb9d79", "name": "Only successfully created snapshots can be deleted.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/delete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "delete" ], "variable": [ { "key": "id" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8f893331-4706-4bc9-84e1-237763eb9d79" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a7b6c359-27cf-45e8-a530-ceaaaa7e2ca8" } ], "id": "ac38340d-7e7d-4564-bf71-f2f0d63104c9", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ac38340d-7e7d-4564-bf71-f2f0d63104c9" }, { "name": "status", "item": [ { "name": "Query the status of an asynchronous disk snapshot.", "id": "ea0eb6d5-d752-4f62-8ef8-59cd36365fc2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "status" ], "variable": [ { "id": "538f0f51-d726-46b0-9d45-dccb2b2dc1a6", "key": "id", "value": "", "description": "(Required) The Snapshot ID." } ] }, "description": "Get the current status of an asynchronous disk snapshot operation, including whether it is still in progress and any error messages if it failed." }, "response": [ { "id": "fa2213c9-9e04-4c7a-aeb0-ec23e7f4dafa", "name": "Snapshot status retrieved successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "status" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"in_progress\",\n \"snapshot\": {\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"laborum29\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n },\n \"error_message\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-fa2213c9-9e04-4c7a-aeb0-ec23e7f4dafa" }, { "id": "491b208e-a5de-4d46-acf5-bd35da418824", "name": "Snapshot not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id", "status" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-491b208e-a5de-4d46-acf5-bd35da418824" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ea0eb6d5-d752-4f62-8ef8-59cd36365fc2" } ], "id": "6999ca98-c0e5-42ce-a5ae-8e54bf5d088c", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6999ca98-c0e5-42ce-a5ae-8e54bf5d088c" }, { "name": "Update metadata of Disk Snapshot.", "id": "598d191d-19e8-494f-952b-6a8b7dc5836a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id" ], "variable": [ { "id": "bf8ead23-e807-4310-8797-998638887465", "key": "id", "value": "", "description": "(Required) The Snapshot ID." } ] }, "description": "Updates disk snapshot metadata via update vs patch. The entire metadata will be replaced." }, "response": [ { "id": "796a333c-56e2-48bc-aa1b-cecb4c61d08e", "name": "Snapshot created successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"adipisicing_fd\": \"\",\n \"sinta\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-796a333c-56e2-48bc-aa1b-cecb4c61d08e" }, { "id": "79ad29cd-0374-4f6f-a723-57495e8679f3", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-79ad29cd-0374-4f6f-a723-57495e8679f3" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-598d191d-19e8-494f-952b-6a8b7dc5836a" } ], "id": "20e814e6-bf22-4c10-bf44-1de4e9c4f28d", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-20e814e6-bf22-4c10-bf44-1de4e9c4f28d" }, { "name": "List disk snapshots of a Devbox.", "id": "2b1ae654-0a8a-4b06-97ad-75be2d320299", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots?devbox_id=&source_blueprint_id=&metadata[key]=&metadata[key][in]=&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots" ], "query": [ { "description": "Devbox ID to filter by.", "key": "devbox_id", "value": "" }, { "description": "Source Blueprint ID to filter snapshots by.", "key": "source_blueprint_id", "value": "" }, { "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys.", "key": "metadata[key]", "value": "" }, { "description": "Filter snapshots by metadata key with multiple possible values (OR condition).", "key": "metadata[key][in]", "value": "" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] }, "description": "List all snapshots of a Devbox while optionally filtering by Devbox ID, source Blueprint ID, and metadata." }, "response": [ { "id": "cc132771-e369-414f-a296-286254920aae", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots?devbox_id=&source_blueprint_id=&metadata[key]=&metadata[key][in]=&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots" ], "query": [ { "description": "Devbox ID to filter by.", "key": "devbox_id", "value": "" }, { "description": "Source Blueprint ID to filter snapshots by.", "key": "source_blueprint_id", "value": "" }, { "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys.", "key": "metadata[key]", "value": "" }, { "description": "Filter snapshots by metadata key with multiple possible values (OR condition).", "key": "metadata[key][in]", "value": "" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"snapshots\": [\n {\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"fugiat_980\": \"\",\n \"occaecat_908\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n },\n {\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"Duis_0d5\": \"\",\n \"culpa607\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n }\n ],\n \"has_more\": \"\",\n \"total_count\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-cc132771-e369-414f-a296-286254920aae" }, { "id": "389e5a45-6ea4-483c-bef1-35fcb7744b7a", "name": "Devbox not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/disk_snapshots?devbox_id=&source_blueprint_id=&metadata[key]=&metadata[key][in]=&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "disk_snapshots" ], "query": [ { "description": "Devbox ID to filter by.", "key": "devbox_id", "value": "" }, { "description": "Source Blueprint ID to filter snapshots by.", "key": "source_blueprint_id", "value": "" }, { "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys.", "key": "metadata[key]", "value": "" }, { "description": "Filter snapshots by metadata key with multiple possible values (OR condition).", "key": "metadata[key][in]", "value": "" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-389e5a45-6ea4-483c-bef1-35fcb7744b7a" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-2b1ae654-0a8a-4b06-97ad-75be2d320299" } ], "id": "bad99854-c87c-4909-a58c-c47c8445ceaf", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-bad99854-c87c-4909-a58c-c47c8445ceaf" }, { "name": "metadata", "item": [ { "name": "keys", "item": [ { "name": "{key}", "item": [ { "name": "values", "item": [ { "name": "List values for a specific devbox metadata key.", "id": "3219b1b2-f839-4021-950e-77c4ec8a2086", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "metadata", "keys", ":key", "values" ], "variable": [ { "id": "3f2c124c-f549-4403-875d-06abb4ccfcf8", "key": "key", "value": "", "description": "(Required) The metadata key to get values for." } ] }, "description": "Returns a list of all values that exist for a specific metadata key across all devboxes." }, "response": [ { "id": "c6411b89-78c4-42d9-85eb-c70a92676dbb", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c6411b89-78c4-42d9-85eb-c70a92676dbb" }, { "id": "9ecdc56d-fc0a-4442-b413-162a5ed8ae76", "name": "Invalid metadata key provided.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/metadata/keys/:key/values", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "metadata", "keys", ":key", "values" ], "variable": [ { "key": "key" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9ecdc56d-fc0a-4442-b413-162a5ed8ae76" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-3219b1b2-f839-4021-950e-77c4ec8a2086" } ], "id": "3435dc62-1c27-41f5-9ee6-ad4af815331a", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-3435dc62-1c27-41f5-9ee6-ad4af815331a" } ], "id": "9b0b1ec0-94aa-4efb-94ad-70bcf6be4e92", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9b0b1ec0-94aa-4efb-94ad-70bcf6be4e92" }, { "name": "List available devbox metadata keys.", "id": "7f9b045c-7261-4a3e-b19f-d0d7739e9f96", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "metadata", "keys" ] }, "description": "Returns a list of all available metadata keys that can be used for filtering devboxes." }, "response": [ { "id": "874b6cce-3e8b-4d31-aca0-948576207459", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/metadata/keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", "metadata", "keys" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"keys\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-874b6cce-3e8b-4d31-aca0-948576207459" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7f9b045c-7261-4a3e-b19f-d0d7739e9f96" } ], "id": "b6324c1d-7f13-4107-84e9-131bd6080aec", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b6324c1d-7f13-4107-84e9-131bd6080aec" } ], "id": "757b5fdd-e05d-486f-ae2a-c4ad3ffa3dad", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-757b5fdd-e05d-486f-ae2a-c4ad3ffa3dad" }, { "name": "{devbox_id}", "item": [ { "name": "executions", "item": [ { "name": "{execution_id}", "item": [ { "name": "kill", "item": [ { "name": "Kill an asynchronous execution currently running on a devbox", "id": "1d9705f0-cad6-4bda-b2cb-84dce743011e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"kill_process_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/kill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "kill" ], "variable": [ { "id": "579bbc6d-8a8d-4f63-a632-07b9b78b5835", "key": "devbox_id", "value": "", "description": "(Required) The Devbox ID." }, { "id": "793e5a97-7f56-480f-8b1a-100ca8cadf2a", "key": "execution_id", "value": "", "description": "(Required) The Async Execution ID." } ] }, "description": "Kill a previously launched asynchronous execution if it is still running by killing the launched process. Optionally kill the entire process group." }, "response": [ { "id": "64363559-2e16-4bf0-91ca-d5ef5adbac06", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"kill_process_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/kill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "kill" ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"status\": \"completed\",\n \"shell_name\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"stdout_truncated\": \"\",\n \"stderr_truncated\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-64363559-2e16-4bf0-91ca-d5ef5adbac06" }, { "id": "2791b6d5-47ae-4321-8455-5a2be0ff3104", "name": "Devbox or Execution not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"kill_process_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/kill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "kill" ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-2791b6d5-47ae-4321-8455-5a2be0ff3104" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-1d9705f0-cad6-4bda-b2cb-84dce743011e" } ], "id": "f445f895-8782-40cb-abe3-ec830477c308", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f445f895-8782-40cb-abe3-ec830477c308" }, { "name": "send_std_in", "item": [ { "name": "Send Content to Std In for a running execution.", "id": "0622d7c3-bc10-4a6d-8f53-f68b0651d04b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"text\": \"\",\n \"signal\": \"EOF\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/send_std_in", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "send_std_in" ], "variable": [ { "id": "f651b4f9-ce8d-4656-b550-bc3970c4c279", "key": "devbox_id", "value": "", "description": "(Required) The Devbox ID." }, { "id": "b30f5d0e-b98a-4ccc-ade8-e9a9d3343d50", "key": "execution_id", "value": "", "description": "(Required) The Async Execution ID." } ] }, "description": "Send content to the Std In of a running execution." }, "response": [ { "id": "e12f6a20-62f5-4a65-814e-5e14d7bfe9a9", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"text\": \"\",\n \"signal\": \"EOF\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/send_std_in", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "send_std_in" ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"success\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-e12f6a20-62f5-4a65-814e-5e14d7bfe9a9" }, { "id": "a3b0d5eb-cc39-4a55-b0ef-21aad71d5679", "name": "Devbox or Execution not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"text\": \"\",\n \"signal\": \"EOF\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/send_std_in", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "send_std_in" ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a3b0d5eb-cc39-4a55-b0ef-21aad71d5679" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-0622d7c3-bc10-4a6d-8f53-f68b0651d04b" } ], "id": "c974989d-c317-4406-9eab-43c20dc17ac9", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c974989d-c317-4406-9eab-43c20dc17ac9" }, { "name": "wait_for_status", "item": [ { "name": "Wait for an asynchronous execution to reach a specific status.", "id": "dd76030e-0b4e-4554-8576-dfb2c9e340e8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"completed\",\n \"running\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/wait_for_status?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "wait_for_status" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "id": "58b91f33-e275-4fda-a0de-652380666be4", "key": "devbox_id", "value": "", "description": "(Required) The Devbox ID." }, { "id": "9592b558-1423-461a-a737-f0dd8ba3ec65", "key": "execution_id", "value": "", "description": "(Required) The Async Execution ID." } ] }, "description": "Polls the asynchronous execution's status until it reaches one of the desired statuses or times out. Max is 25 seconds." }, "response": [ { "id": "f6629e23-3895-411d-a75f-4eab0985ef59", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"completed\",\n \"running\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/wait_for_status?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "wait_for_status" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"status\": \"completed\",\n \"shell_name\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"stdout_truncated\": \"\",\n \"stderr_truncated\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f6629e23-3895-411d-a75f-4eab0985ef59" }, { "id": "2d1efcdf-1766-4785-b1fd-f3a540e0e185", "name": "Invalid status provided or Devbox not in proper state.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"completed\",\n \"running\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/wait_for_status?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "wait_for_status" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-2d1efcdf-1766-4785-b1fd-f3a540e0e185" }, { "id": "c7cddd85-ac1b-4f26-9dc5-6ce7ecea823d", "name": "Devbox or Execution not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"completed\",\n \"running\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/wait_for_status?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "wait_for_status" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c7cddd85-ac1b-4f26-9dc5-6ce7ecea823d" }, { "id": "52f9d6b1-ba0d-4f88-a411-c940b45419ec", "name": "Timeout waiting for command completion.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"completed\",\n \"running\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id/wait_for_status?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id", "wait_for_status" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Request Timeout", "code": 408, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-52f9d6b1-ba0d-4f88-a411-c940b45419ec" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-dd76030e-0b4e-4554-8576-dfb2c9e340e8" } ], "id": "09455598-8556-4070-93f2-aafca09b75d2", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-09455598-8556-4070-93f2-aafca09b75d2" }, { "name": "Get status of an asynchronous execution on a Devbox.", "id": "a7e924d9-6ffb-41b6-a149-1598df29e35b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "id": "58ad6233-719a-4a6a-b866-f586c50b617d", "key": "devbox_id", "value": "", "description": "(Required) The Devbox ID" }, { "id": "d1654d96-51b0-49a6-b061-ccbdcc648b67", "key": "execution_id", "value": "", "description": "(Required) The Execution ID" } ] }, "description": "Get the latest status of a previously launched asynchronous execuction including stdout/error and the exit code if complete." }, "response": [ { "id": "73b07b15-d78d-463a-9db9-238cc1affb82", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"status\": \"completed\",\n \"shell_name\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"stdout_truncated\": \"\",\n \"stderr_truncated\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-73b07b15-d78d-463a-9db9-238cc1affb82" }, { "id": "88bb77c4-0839-434b-a2de-8016576d14e0", "name": "Devbox not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:devbox_id/executions/:execution_id?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":devbox_id", "executions", ":execution_id" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "devbox_id" }, { "key": "execution_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-88bb77c4-0839-434b-a2de-8016576d14e0" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a7e924d9-6ffb-41b6-a149-1598df29e35b" } ], "id": "3e69ea9c-27c0-44d2-8518-a006c01a21b3", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-3e69ea9c-27c0-44d2-8518-a006c01a21b3" } ], "id": "66c373ec-24cb-45ae-b1af-f9086f8213b5", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-66c373ec-24cb-45ae-b1af-f9086f8213b5" } ], "id": "8aa61763-7bfa-4ffe-a072-96d1bec616fa", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8aa61763-7bfa-4ffe-a072-96d1bec616fa" }, { "name": "{id}", "item": [ { "name": "create_pty_tunnel", "item": [ { "name": "Create an ephemeral PTY tunnel for a running Devbox.", "id": "8cfb1a3a-b539-4a8d-8d37-8cc4cbc84915", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_pty_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_pty_tunnel" ], "variable": [ { "id": "e56a1080-d694-4d1e-aa91-922d84a8bb8d", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Create an ephemeral authenticated tunnel for terminal access to a running Devbox. This tunnel is not persisted on the Devbox and is generated fresh on each request. The returned auth_token must be passed as a Bearer token in the Authorization header." }, "response": [ { "id": "524b98a7-409d-440a-a193-e12f45c3c0fd", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_pty_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_pty_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"tunnel_key\": \"\",\n \"auth_token\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-524b98a7-409d-440a-a193-e12f45c3c0fd" }, { "id": "c55c600a-a785-4b6e-9d37-1d8eae89ca92", "name": "Devbox is not currently running.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_pty_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_pty_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c55c600a-a785-4b6e-9d37-1d8eae89ca92" }, { "id": "2a2d25c2-fec2-4d22-bd2c-a214d87bbe76", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_pty_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_pty_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-2a2d25c2-fec2-4d22-bd2c-a214d87bbe76" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8cfb1a3a-b539-4a8d-8d37-8cc4cbc84915" } ], "id": "4db60d65-3fb5-4827-b258-705bd0a09d70", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-4db60d65-3fb5-4827-b258-705bd0a09d70" }, { "name": "create_ssh_key", "item": [ { "name": "Create an SSH key for a Devbox", "id": "72e5ee31-75d4-4598-89ee-c54741781f89", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_ssh_key", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_ssh_key" ], "variable": [ { "id": "893fc43a-f65c-4aeb-afcf-023dce5a231e", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Create an SSH key for a Devbox to enable remote access." }, "response": [ { "id": "4c0e40cf-05d2-482d-909b-8fcbd0aa1e69", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_ssh_key", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_ssh_key" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"url\": \"\",\n \"ssh_private_key\": \"\",\n \"ssh_user\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-4c0e40cf-05d2-482d-909b-8fcbd0aa1e69" }, { "id": "decd5426-2eda-4785-9a29-75ccd7a5f3dc", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/create_ssh_key", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "create_ssh_key" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-decd5426-2eda-4785-9a29-75ccd7a5f3dc" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-72e5ee31-75d4-4598-89ee-c54741781f89" } ], "id": "328150ab-2d52-4ddf-803d-d6537f2f0e00", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-328150ab-2d52-4ddf-803d-d6537f2f0e00" }, { "name": "download_file", "item": [ { "name": "Download binary file contents from Devbox filesystem.", "id": "b1a80c0d-3810-4e3f-a4fb-c5ab2f588a04", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/octet-stream" } ], "body": { "mode": "raw", "raw": "{\n \"path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/download_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "download_file" ], "variable": [ { "id": "3f03a36e-84e6-4ad8-9721-499ed11393a5", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Download file contents of any type (binary, text, etc) from a specified path on the Devbox." }, "response": [ { "id": "8b472a1e-a303-451a-a1af-42c91a4be936", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/octet-stream" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/download_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "download_file" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/octet-stream" }, { "disabled": false, "description": { "content": "(Required) application/octet-stream", "type": "text/plain" }, "key": "Content-Type", "value": "" }, { "disabled": false, "description": { "content": "(Required) attachment", "type": "text/plain" }, "key": "Content-Disposition", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"format\": \"binary\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8b472a1e-a303-451a-a1af-42c91a4be936" }, { "id": "72c866fb-968e-4368-b864-ddd1721c2576", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/download_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "download_file" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-72c866fb-968e-4368-b864-ddd1721c2576" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b1a80c0d-3810-4e3f-a4fb-c5ab2f588a04" } ], "id": "8bd925ff-474e-401f-9f05-ed5d973f2f70", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8bd925ff-474e-401f-9f05-ed5d973f2f70" }, { "name": "enable_tunnel", "item": [ { "name": "Enable a tunnel for a running Devbox.", "id": "dc6e5a40-8fe1-498d-9586-648b34cee287", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/enable_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "enable_tunnel" ], "variable": [ { "id": "9c894557-8261-421a-9678-f76f19cbdab8", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Enable a V2 tunnel for an existing running Devbox. Tunnels provide encrypted URL-based access to the Devbox without exposing internal IDs. The tunnel URL format is: https://{port}-{tunnel_key}.tunnel.runloop.ai\n\nEach Devbox can have one tunnel." }, "response": [ { "id": "7fcd3ab0-5df0-49ea-8463-068298c5105d", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/enable_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "enable_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7fcd3ab0-5df0-49ea-8463-068298c5105d" }, { "id": "82f5e83b-8486-4177-a876-b48408672c67", "name": "Devbox is not running or already has a tunnel configured.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/enable_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "enable_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-82f5e83b-8486-4177-a876-b48408672c67" }, { "id": "9d82ecf8-2772-48ac-a89a-312fb6f8b37e", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/enable_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "enable_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9d82ecf8-2772-48ac-a89a-312fb6f8b37e" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-dc6e5a40-8fe1-498d-9586-648b34cee287" } ], "id": "40185a7d-7360-44c0-bc43-6d9391851ae5", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-40185a7d-7360-44c0-bc43-6d9391851ae5" }, { "name": "execute", "item": [ { "name": "Execute a command with a known ID, optimistically waiting for completion", "id": "6f60e3c0-ce65-4414-8df3-3b814a5e0a69", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"command_id\": \"\",\n \"command\": \"\",\n \"shell_name\": \"\",\n \"optimistic_timeout\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "id": "679407ff-e3a0-4ec4-8f37-15df6371a7d5", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Execute a command with a known command ID on a devbox, optimistically waiting for it to complete within the specified timeout. If it completes in time, return the result. If not, return a status indicating the command is still running. Note: attach_stdin parameter is not supported; use execute_async for stdin support." }, "response": [ { "id": "ec4341c9-9322-4475-9053-6adc14a7410c", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command_id\": \"\",\n \"command\": \"\",\n \"shell_name\": \"\",\n \"optimistic_timeout\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"status\": \"completed\",\n \"shell_name\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"stdout_truncated\": \"\",\n \"stderr_truncated\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ec4341c9-9322-4475-9053-6adc14a7410c" }, { "id": "f5063d1a-b078-4d6f-b6e1-43b5922cbd25", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command_id\": \"\",\n \"command\": \"\",\n \"shell_name\": \"\",\n \"optimistic_timeout\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f5063d1a-b078-4d6f-b6e1-43b5922cbd25" }, { "id": "82a00638-f5a6-4503-a212-297ca6c20c89", "name": "Command timed out.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command_id\": \"\",\n \"command\": \"\",\n \"shell_name\": \"\",\n \"optimistic_timeout\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute?last_n=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute" ], "query": [ { "description": "Last n lines of standard error / standard out to return (default: 100)", "key": "last_n", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Request Timeout", "code": 408, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-82a00638-f5a6-4503-a212-297ca6c20c89" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6f60e3c0-ce65-4414-8df3-3b814a5e0a69" } ], "id": "87a5fc51-7d02-4934-a001-7943e3e6db88", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-87a5fc51-7d02-4934-a001-7943e3e6db88" }, { "name": "execute_async", "item": [ { "name": "Asynchronously execute a command via the Devbox shell", "id": "d5d59e85-7ba0-4788-b89b-be614a3ff5d0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"shell_name\": \"\",\n \"attach_stdin\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute_async" ], "variable": [ { "id": "2c6fdc0c-fe74-4e0d-824c-f334a7a69408", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Execute the given command in the Devbox shell asynchronously and returns the execution that can be used to track the command's progress." }, "response": [ { "id": "fa9b0e92-2024-439b-9d1c-3bf2cbc841c4", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"shell_name\": \"\",\n \"attach_stdin\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute_async" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"execution_id\": \"\",\n \"status\": \"completed\",\n \"shell_name\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"stdout_truncated\": \"\",\n \"stderr_truncated\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-fa9b0e92-2024-439b-9d1c-3bf2cbc841c4" }, { "id": "ac2f24d2-1dc7-422c-a805-ff65143e1530", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"shell_name\": \"\",\n \"attach_stdin\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute_async" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ac2f24d2-1dc7-422c-a805-ff65143e1530" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d5d59e85-7ba0-4788-b89b-be614a3ff5d0" } ], "id": "d6e882be-7d1e-43fe-8c0e-2235d06f58ff", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d6e882be-7d1e-43fe-8c0e-2235d06f58ff" }, { "name": "execute_sync", "item": [ { "name": "(Deprecated, please use /execute_async) Synchronously execute a shell command on a Devbox", "id": "f607c45a-de85-4ab4-8298-dfb0cab3543f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"shell_name\": \"\",\n \"attach_stdin\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute_sync", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute_sync" ], "variable": [ { "id": "f36a6895-f6e6-47cd-9794-b59d63e26442", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Execute a bash command in the Devbox shell, await the command completion and return the output. Note: attach_stdin parameter is not supported for synchronous execution." }, "response": [ { "id": "a7c90c14-09fc-41b5-a225-e6e4f38ff0a7", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"shell_name\": \"\",\n \"attach_stdin\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/execute_sync", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "execute_sync" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"shell_name\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a7c90c14-09fc-41b5-a225-e6e4f38ff0a7" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f607c45a-de85-4ab4-8298-dfb0cab3543f" } ], "id": "b6cb2133-6b76-4265-a644-9e717dae34d4", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b6cb2133-6b76-4265-a644-9e717dae34d4" }, { "name": "keep_alive", "item": [ { "name": "Reset the idle timer of a running Devbox.", "id": "0bc21234-beb6-437d-ad27-e7dc3b53b6a2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/keep_alive", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "keep_alive" ], "variable": [ { "id": "d2b56b01-2ee9-4580-9e49-edd8a982573a", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Send a 'Keep Alive' signal to a running Devbox that is configured to shutdown on idle so the idle time resets." }, "response": [ { "id": "4dd36920-78e3-40b8-a759-b4089781ad1a", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/keep_alive", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "keep_alive" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-4dd36920-78e3-40b8-a759-b4089781ad1a" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-0bc21234-beb6-437d-ad27-e7dc3b53b6a2" } ], "id": "3335ac7f-585b-43f9-ae29-5274eb0735eb", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-3335ac7f-585b-43f9-ae29-5274eb0735eb" }, { "name": "logs", "item": [ { "name": "tail", "item": [ { "name": "Live Tail Devbox Logs.", "id": "67d26ff7-845d-4be6-a3a9-4cb9caa8c484", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs/tail?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs", "tail" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "id": "db7d2eb2-f4d3-4274-933c-4eab5204bf6e", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Tail the logs for the given devbox. This will return past log entries and continue streaming from there. The stream will then continue to stream logs until the connection is closed." }, "response": [ { "id": "a416e96a-7d0e-44cc-8fa6-ee2996fbe965", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs/tail?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs", "tail" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "disabled": false, "description": { "content": "text/event-stream", "type": "text/plain" }, "key": "Content-Type", "value": "" } ], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a416e96a-7d0e-44cc-8fa6-ee2996fbe965" }, { "id": "54866765-8f62-4102-9a16-41b8fa233aee", "name": "Devbox not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs/tail?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs", "tail" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-54866765-8f62-4102-9a16-41b8fa233aee" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-67d26ff7-845d-4be6-a3a9-4cb9caa8c484" } ], "id": "e61223a6-4993-487f-9ed0-2cbfdd8d4196", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-e61223a6-4993-487f-9ed0-2cbfdd8d4196" }, { "name": "Get Devbox logs.", "id": "7edb858f-a8ca-496f-9767-515a9d3a9494", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "id": "21585b71-ff9b-4df9-8676-7181d844a6f9", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Get all logs from a running or completed Devbox." }, "response": [ { "id": "17ccfd2c-f619-4b10-9aa5-4cff69aafcae", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"logs\": [\n {\n \"level\": \"\",\n \"timestamp_ms\": \"\",\n \"source\": \"setup_commands\",\n \"cmd_id\": \"\",\n \"shell_name\": \"\",\n \"cmd\": \"\",\n \"message\": \"\",\n \"exit_code\": \"\"\n },\n {\n \"level\": \"\",\n \"timestamp_ms\": \"\",\n \"source\": \"exec\",\n \"cmd_id\": \"\",\n \"shell_name\": \"\",\n \"cmd\": \"\",\n \"message\": \"\",\n \"exit_code\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-17ccfd2c-f619-4b10-9aa5-4cff69aafcae" }, { "id": "1f6fee3b-96c3-4090-844d-b4f06e647411", "name": "Devbox not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/logs?execution_id=&shell_name=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "logs" ], "query": [ { "description": "ID of execution to filter logs by.", "key": "execution_id", "value": "" }, { "description": "Shell Name to filter logs by.", "key": "shell_name", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-1f6fee3b-96c3-4090-844d-b4f06e647411" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7edb858f-a8ca-496f-9767-515a9d3a9494" } ], "id": "f878584d-0467-4b1a-8c5e-cc29f929a8ae", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f878584d-0467-4b1a-8c5e-cc29f929a8ae" }, { "name": "read_file_contents", "item": [ { "name": "Read text file contents from Devbox filesystem.", "id": "18dd98ac-f638-42b3-9855-85d920650b2e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "text/plain" } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/read_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "read_file_contents" ], "variable": [ { "id": "52c3c01f-133d-437a-932e-7cc61510e200", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Read file contents from a file on a Devbox as a UTF-8. Note 'downloadFile' should be used for large files (greater than 100MB). Returns the file contents as a UTF-8 string." }, "response": [ { "id": "acd2d47d-dd3d-4521-8a27-ee9e30ea3271", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "text/plain" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/read_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "read_file_contents" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "text/plain" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-acd2d47d-dd3d-4521-8a27-ee9e30ea3271" }, { "id": "701fd320-c31b-4f49-abdb-23f90bc90161", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/read_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "read_file_contents" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-701fd320-c31b-4f49-abdb-23f90bc90161" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-18dd98ac-f638-42b3-9855-85d920650b2e" } ], "id": "9aa42630-0881-4b04-841e-5ea31ca64d8a", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9aa42630-0881-4b04-841e-5ea31ca64d8a" }, { "name": "remove_tunnel", "item": [ { "name": "Remove a tunnel from the Devbox.", "id": "81ca08a9-f36d-4636-8ac6-6a79ee42ddec", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/remove_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "remove_tunnel" ], "variable": [ { "id": "1cc140b2-e58b-4962-9478-e4d0294a2465", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Remove an existing V2 tunnel from the Devbox." }, "response": [ { "id": "7ce2efa2-b8b0-4bdd-90a4-47db496aa8ae", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/remove_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "remove_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7ce2efa2-b8b0-4bdd-90a4-47db496aa8ae" }, { "id": "1cb993f6-45e6-4dac-8dc0-76eaae9e0f7c", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/remove_tunnel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "remove_tunnel" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-1cb993f6-45e6-4dac-8dc0-76eaae9e0f7c" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-81ca08a9-f36d-4636-8ac6-6a79ee42ddec" } ], "id": "c6973af8-edfc-4f5c-89f4-65e1acaf18fd", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c6973af8-edfc-4f5c-89f4-65e1acaf18fd" }, { "name": "resume", "item": [ { "name": "Resume a suspended Devbox", "id": "a160a41d-3ce5-4320-ac31-4ffe4cda9895", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/resume", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "resume" ], "variable": [ { "id": "67b84246-367c-47bc-946e-38de540d8e6f", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Resume a suspended Devbox with the disk state captured as suspend time. Note that any previously running processes or daemons will need to be restarted using the Devbox shell tools." }, "response": [ { "id": "7ef822df-136b-44b1-98f2-c1e5b11c3ba0", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/resume", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "resume" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7ef822df-136b-44b1-98f2-c1e5b11c3ba0" }, { "id": "6b027659-768e-4efd-8b2b-85c78dfa6b07", "name": "Devbox is not suspended.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/resume", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "resume" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6b027659-768e-4efd-8b2b-85c78dfa6b07" }, { "id": "195be3d0-3b89-4051-9b27-17adee2da38a", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/resume", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "resume" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-195be3d0-3b89-4051-9b27-17adee2da38a" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a160a41d-3ce5-4320-ac31-4ffe4cda9895" } ], "id": "8fb6ab0b-d20b-4204-adfd-18e9ef3a385f", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8fb6ab0b-d20b-4204-adfd-18e9ef3a385f" }, { "name": "shutdown", "item": [ { "name": "Shutdown a running Devbox.", "id": "ed219d06-4b7b-466b-a9c6-43188afabea3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/shutdown?force=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "shutdown" ], "query": [ { "description": "If true, force shutdown even if snapshots are in progress. Defaults to false.", "key": "force", "value": "" } ], "variable": [ { "id": "75793934-518b-4dd1-a040-eea42f512376", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Shutdown a running Devbox. This will permanently stop the Devbox. If you want to save the state of the Devbox, you should take a snapshot before shutting down or should suspend the Devbox instead of shutting down. If the Devbox has any in-progress snapshots, the shutdown will be rejected with a 409 Conflict unless force=true is specified." }, "response": [ { "id": "16deca97-919e-40b5-9081-bd0d98414ed6", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/shutdown?force=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "shutdown" ], "query": [ { "description": "If true, force shutdown even if snapshots are in progress. Defaults to false.", "key": "force", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-16deca97-919e-40b5-9081-bd0d98414ed6" }, { "id": "9e1636fb-2760-44d0-92a5-9385ed4de625", "name": "Devbox has in-progress snapshots and cannot be shut down at this time. Use force=true to override.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/shutdown?force=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "shutdown" ], "query": [ { "description": "If true, force shutdown even if snapshots are in progress. Defaults to false.", "key": "force", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9e1636fb-2760-44d0-92a5-9385ed4de625" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ed219d06-4b7b-466b-a9c6-43188afabea3" } ], "id": "8ed2d7c3-d303-4db0-83c3-2f4c0c6c9558", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8ed2d7c3-d303-4db0-83c3-2f4c0c6c9558" }, { "name": "snapshot_disk", "item": [ { "name": "Synchronously create a disk snapshot of a running Devbox.", "id": "a7a3d2cf-9dcc-46d3-aacf-8750c3d696fa", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk" ], "variable": [ { "id": "6bcb6dbc-492c-43a7-99ae-670c2ff75229", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Create a disk snapshot of a devbox with the specified name and metadata to enable launching future Devboxes with the same disk state." }, "response": [ { "id": "215ea266-7d1f-4e1c-b1a5-a2f2105cdabe", "name": "Snapshot created successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"adipisicing_fd\": \"\",\n \"sinta\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-215ea266-7d1f-4e1c-b1a5-a2f2105cdabe" }, { "id": "5b19797e-b99a-41b3-8c74-0d6a8534748a", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5b19797e-b99a-41b3-8c74-0d6a8534748a" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a7a3d2cf-9dcc-46d3-aacf-8750c3d696fa" } ], "id": "f038939e-40ec-49a3-971d-696b92f46fae", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-f038939e-40ec-49a3-971d-696b92f46fae" }, { "name": "snapshot_disk_async", "item": [ { "name": "Start an asynchronous disk snapshot of a running Devbox.", "id": "55b23a4b-dc5d-459b-acb6-d47d6cb92845", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk_async" ], "variable": [ { "id": "c817c279-4dc1-421c-a1c7-5d5e40e72e25", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Start an asynchronous disk snapshot of a devbox with the specified name and metadata. The snapshot operation will continue in the background and can be monitored using the query endpoint." }, "response": [ { "id": "339a7f96-f861-490a-a84c-8aaff85ac48d", "name": "Snapshot operation started successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk_async" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"create_time_ms\": \"\",\n \"metadata\": {\n \"adipisicing_fd\": \"\",\n \"sinta\": \"\"\n },\n \"source_devbox_id\": \"\",\n \"name\": \"\",\n \"source_blueprint_id\": \"\",\n \"commit_message\": \"\",\n \"size_bytes\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-339a7f96-f861-490a-a84c-8aaff85ac48d" }, { "id": "029d3d80-44c4-4720-aba8-1e733c47f50f", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"incididunt1\": \"\",\n \"Duis_2__\": \"\"\n },\n \"commit_message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/snapshot_disk_async", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "snapshot_disk_async" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-029d3d80-44c4-4720-aba8-1e733c47f50f" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-55b23a4b-dc5d-459b-acb6-d47d6cb92845" } ], "id": "c3a1bdc3-7b1c-4fa8-a327-b37da4059a52", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-c3a1bdc3-7b1c-4fa8-a327-b37da4059a52" }, { "name": "suspend", "item": [ { "name": "Suspend a running Devbox", "id": "fb41b0b0-85c7-44be-8685-af69ac7d282f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/suspend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "suspend" ], "variable": [ { "id": "b0ce50ea-6ddc-45c9-bf89-a3802f1d3ceb", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Suspend a running Devbox and create a disk snapshot to enable resuming the Devbox later with the same disk. Note this will not snapshot memory state such as running processes." }, "response": [ { "id": "ba60ea23-4643-44ae-998f-5ac9466da229", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/suspend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "suspend" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ba60ea23-4643-44ae-998f-5ac9466da229" }, { "id": "60270e99-ff8f-4130-8e41-826467b42676", "name": "Devbox is not running.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/suspend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "suspend" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-60270e99-ff8f-4130-8e41-826467b42676" }, { "id": "854b98e1-8e65-410d-b03b-b2ad8a503100", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/suspend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "suspend" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-854b98e1-8e65-410d-b03b-b2ad8a503100" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-fb41b0b0-85c7-44be-8685-af69ac7d282f" } ], "id": "b2c87792-dadf-4217-b441-88480c9e6c5d", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b2c87792-dadf-4217-b441-88480c9e6c5d" }, { "name": "upload_file", "item": [ { "name": "Upload binary file contents to Devbox filesystem.", "id": "ef805dac-a243-4199-aadd-63e1f871ff84", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The path to write the file to on the Devbox. Path is relative to user home directory.", "key": "path", "value": "", "type": "text" }, { "key": "file", "type": "file", "value": null } ] }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/upload_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "upload_file" ], "variable": [ { "id": "320a62a3-64bf-4f74-a63f-95d77ea8aa77", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Upload file contents of any type (binary, text, etc) to a Devbox. Note this API is suitable for large files (larger than 100MB) and efficiently uploads files via multipart form data." }, "response": [ { "id": "74ade5ed-f89d-4b0d-9863-ab9e6f0b5d4e", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The path to write the file to on the Devbox. Path is relative to user home directory.", "key": "path", "value": "", "type": "text" }, { "key": "file", "type": "file" } ] }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/upload_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "upload_file" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-74ade5ed-f89d-4b0d-9863-ab9e6f0b5d4e" }, { "id": "5915cf64-df2a-4831-a555-5f4bb51b47ed", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The path to write the file to on the Devbox. Path is relative to user home directory.", "key": "path", "value": "", "type": "text" }, { "key": "file", "type": "file" } ] }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/upload_file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "upload_file" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5915cf64-df2a-4831-a555-5f4bb51b47ed" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ef805dac-a243-4199-aadd-63e1f871ff84" } ], "id": "b0d162d9-7abe-40a8-b276-67ad8475167b", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b0d162d9-7abe-40a8-b276-67ad8475167b" }, { "name": "usage", "item": [ { "name": "Get resource usage for a Devbox.", "id": "0bba40e3-179f-48fb-9298-1d7610f87aee", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "usage" ], "variable": [ { "id": "c83eb762-7462-4d91-85be-b92d76a16259", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Get resource usage metrics for a specific Devbox. Returns CPU, memory, and disk consumption calculated from the Devbox's lifecycle, excluding any suspended periods for CPU and memory. Disk usage includes the full elapsed time since storage is consumed even when suspended." }, "response": [ { "id": "455e89a1-8622-41ee-9453-507853a110e3", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "usage" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"total_active_seconds\": \"\",\n \"total_elapsed_seconds\": \"\",\n \"vcpu_seconds\": \"\",\n \"memory_gb_seconds\": \"\",\n \"disk_gb_seconds\": \"\",\n \"start_time_ms\": \"\",\n \"status\": \"\",\n \"end_time_ms\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-455e89a1-8622-41ee-9453-507853a110e3" }, { "id": "9009b3aa-943f-4fe0-8d14-04d244de1e32", "name": "Devbox not found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "usage" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-9009b3aa-943f-4fe0-8d14-04d244de1e32" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-0bba40e3-179f-48fb-9298-1d7610f87aee" } ], "id": "2d27cc9e-ee5f-4e32-99e9-65f58689bebf", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-2d27cc9e-ee5f-4e32-99e9-65f58689bebf" }, { "name": "wait_for_status", "item": [ { "name": "Wait for a Devbox to reach one of the specified statuses.", "id": "b7fc9343-e32c-46bf-a4c4-20ddc6b91ad1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"resuming\",\n \"suspended\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/wait_for_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "wait_for_status" ], "variable": [ { "id": "11b2627a-d5f2-479a-ad3f-9786b8f4774f", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Polls the Devbox's status until it reaches one of the desired statuses or times out." }, "response": [ { "id": "6b343690-ea47-4e6a-969a-af282b54843d", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"resuming\",\n \"suspended\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/wait_for_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "wait_for_status" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6b343690-ea47-4e6a-969a-af282b54843d" }, { "id": "72ff3c33-64da-4c20-a78b-d92af718137d", "name": "Invalid status provided.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"resuming\",\n \"suspended\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/wait_for_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "wait_for_status" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-72ff3c33-64da-4c20-a78b-d92af718137d" }, { "id": "46998907-5840-4ddd-91aa-9269d507ddac", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"resuming\",\n \"suspended\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/wait_for_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "wait_for_status" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-46998907-5840-4ddd-91aa-9269d507ddac" }, { "id": "ba616db1-d3bb-43c6-9f62-6068194d0d5f", "name": "Timeout waiting for status.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"statuses\": [\n \"resuming\",\n \"suspended\"\n ],\n \"timeout_seconds\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/wait_for_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "wait_for_status" ], "variable": [ { "key": "id" } ] } }, "status": "Request Timeout", "code": 408, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-ba616db1-d3bb-43c6-9f62-6068194d0d5f" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b7fc9343-e32c-46bf-a4c4-20ddc6b91ad1" } ], "id": "a02add84-ee81-416c-98ce-5506b1a3acfa", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-a02add84-ee81-416c-98ce-5506b1a3acfa" }, { "name": "write_file_contents", "item": [ { "name": "Write text file contents to Devbox filesystem.", "id": "d1027d11-cf37-4f11-b382-2b7c9eb4808f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\",\n \"contents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/write_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "write_file_contents" ], "variable": [ { "id": "485fb4f3-443e-4c8c-bcb6-abcfeb8e7517", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Write UTF-8 string contents to a file at path on the Devbox. Note for large files (larger than 100MB), the upload_file endpoint must be used." }, "response": [ { "id": "6944dabb-aa7b-4ba1-b89b-8c796184d5c4", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\",\n \"contents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/write_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "write_file_contents" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devbox_id\": \"\",\n \"stdout\": \"\",\n \"stderr\": \"\",\n \"exit_status\": \"\",\n \"shell_name\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6944dabb-aa7b-4ba1-b89b-8c796184d5c4" }, { "id": "5e351e45-0524-477d-8616-8285ee7c69f7", "name": "Devbox not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_path\": \"\",\n \"contents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id/write_file_contents", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id", "write_file_contents" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5e351e45-0524-477d-8616-8285ee7c69f7" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d1027d11-cf37-4f11-b382-2b7c9eb4808f" } ], "id": "7ff24718-a56f-46fc-86fa-88759c2a12cf", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7ff24718-a56f-46fc-86fa-88759c2a12cf" }, { "name": "Update a Devbox.", "id": "92c85c9e-8517-4666-9b87-531e653673bf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"laboris6_\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id" ], "variable": [ { "id": "8c959848-276c-4879-b0ce-de813ad0adbd", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Updates a devbox by doing a complete update the existing name,metadata fields. It does not patch partial values." }, "response": [ { "id": "5847d837-17b1-407e-8141-cffe979e0d85", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"metadata\": {\n \"laboris6_\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-5847d837-17b1-407e-8141-cffe979e0d85" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-92c85c9e-8517-4666-9b87-531e653673bf" }, { "name": "Get Devbox details.", "id": "7100b6ff-4f9b-4965-a56c-21d508cb749f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id" ], "variable": [ { "id": "70a12657-0122-4ee0-b2a7-eeb72b14e74f", "key": "id", "value": "", "description": "(Required) The Devbox ID." } ] }, "description": "Get the latest details and status of a Devbox." }, "response": [ { "id": "b44972af-f805-45c1-a976-c79573d48211", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b44972af-f805-45c1-a976-c79573d48211" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-7100b6ff-4f9b-4965-a56c-21d508cb749f" } ], "id": "b75d2ac7-3679-441d-a840-944f61e8b99f", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-b75d2ac7-3679-441d-a840-944f61e8b99f" }, { "name": "Create a Devbox.", "id": "05532619-4809-4fe4-bdbe-99cceded228c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"environment_variables\": {\n \"officia_b19\": \"\"\n },\n \"secrets\": {\n \"est_74\": \"\"\n },\n \"file_mounts\": {\n \"irured0\": \"\"\n },\n \"entrypoint\": \"\",\n \"blueprint_id\": \"\",\n \"blueprint_name\": \"\",\n \"repo_connection_id\": \"\",\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"CUSTOM_SIZE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"arm64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"snapshot_id\": \"\",\n \"metadata\": {\n \"ut_3\": \"\",\n \"utfb9\": \"\",\n \"sintce6\": \"\"\n },\n \"code_mounts\": [\n {\n \"repo_name\": \"\",\n \"repo_owner\": \"\",\n \"install_command\": \"\",\n \"git_ref\": \"\",\n \"token\": \"\"\n },\n {\n \"repo_name\": \"\",\n \"repo_owner\": \"\",\n \"install_command\": \"\",\n \"git_ref\": \"\",\n \"token\": \"\"\n }\n ],\n \"mounts\": [\n {\n \"object_id\": \"\",\n \"object_path\": \"\",\n \"type\": \"object_mount\"\n },\n {\n \"object_id\": \"\",\n \"object_path\": \"\",\n \"type\": \"object_mount\"\n }\n ],\n \"tunnel\": {\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n },\n \"gateways\": {\n \"anima\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"nullae7\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"sunte2\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"aliquip_7\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n }\n },\n \"mcp\": {\n \"aute4b\": {\n \"mcp_config\": \"\",\n \"secret\": \"\"\n },\n \"in_c75\": {\n \"mcp_config\": \"\",\n \"secret\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes" ] }, "description": "Create a Devbox and begin the boot process. The Devbox will initially launch in the 'provisioning' state while Runloop allocates the necessary infrastructure. It will transition to the 'initializing' state while the booted Devbox runs any Runloop or user defined set up scripts. Finally, the Devbox will transition to the 'running' state when it is ready for use." }, "response": [ { "id": "cdbfe72d-765d-4900-a23e-b34854eca7f6", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"environment_variables\": {\n \"officia_b19\": \"\"\n },\n \"secrets\": {\n \"est_74\": \"\"\n },\n \"file_mounts\": {\n \"irured0\": \"\"\n },\n \"entrypoint\": \"\",\n \"blueprint_id\": \"\",\n \"blueprint_name\": \"\",\n \"repo_connection_id\": \"\",\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"CUSTOM_SIZE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"arm64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"snapshot_id\": \"\",\n \"metadata\": {\n \"ut_3\": \"\",\n \"utfb9\": \"\",\n \"sintce6\": \"\"\n },\n \"code_mounts\": [\n {\n \"repo_name\": \"\",\n \"repo_owner\": \"\",\n \"install_command\": \"\",\n \"git_ref\": \"\",\n \"token\": \"\"\n },\n {\n \"repo_name\": \"\",\n \"repo_owner\": \"\",\n \"install_command\": \"\",\n \"git_ref\": \"\",\n \"token\": \"\"\n }\n ],\n \"mounts\": [\n {\n \"object_id\": \"\",\n \"object_path\": \"\",\n \"type\": \"object_mount\"\n },\n {\n \"object_id\": \"\",\n \"object_path\": \"\",\n \"type\": \"object_mount\"\n }\n ],\n \"tunnel\": {\n \"auth_mode\": \"open\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\"\n },\n \"gateways\": {\n \"anima\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"nullae7\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"sunte2\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n },\n \"aliquip_7\": {\n \"gateway\": \"\",\n \"secret\": \"\"\n }\n },\n \"mcp\": {\n \"aute4b\": {\n \"mcp_config\": \"\",\n \"secret\": \"\"\n },\n \"in_c75\": {\n \"mcp_config\": \"\",\n \"secret\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/devboxes", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"status\": \"running\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"culpa__\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"XX_LARGE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"failure\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_disk\",\n \"shutdown_reason\": \"idle\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"authenticated\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"magna_31b\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut__\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"officia5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"eu1\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-cdbfe72d-765d-4900-a23e-b34854eca7f6" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-05532619-4809-4fe4-bdbe-99cceded228c" }, { "name": "List Devboxes.", "id": "71e3421f-de84-418b-bc69-b2eb0f7abe70", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/devboxes?status=suspending&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes" ], "query": [ { "description": "Filter by status", "key": "status", "value": "suspending" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] }, "description": "List all Devboxes while optionally filtering by status." }, "response": [ { "id": "6036d57a-35e6-4a0b-94ac-4671d41edc3d", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/devboxes?status=suspending&limit=&starting_after=&include_total_count=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "devboxes" ], "query": [ { "description": "Filter by status", "key": "status", "value": "suspending" }, { "description": "The limit of items to return. Default is 20. Max is 5000.", "key": "limit", "value": "" }, { "description": "Load the next page of data starting after the item with the given ID.", "key": "starting_after", "value": "" }, { "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets.", "key": "include_total_count", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devboxes\": [\n {\n \"id\": \"\",\n \"status\": \"provisioning\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"deserunta\": \"\",\n \"laborum_5\": \"\",\n \"in_b\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"X_SMALL\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"suspend\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"unknown\",\n \"docker_in_docker\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"shutdown\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"shutdown\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"scenario\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"health_check_failed\",\n \"shutdown_reason\": \"ttl_expired\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"open\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"mollit73\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"quis_807\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"pariatur_d1e\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"nostrud_64\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ut_83\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"proidentd\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"laborum_0f\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"dolore_70\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n },\n {\n \"id\": \"\",\n \"status\": \"resuming\",\n \"create_time_ms\": \"\",\n \"end_time_ms\": \"\",\n \"metadata\": {\n \"in_b\": \"\"\n },\n \"launch_parameters\": {\n \"launch_commands\": [\n \"\",\n \"\"\n ],\n \"resource_size_request\": \"CUSTOM_SIZE\",\n \"available_ports\": [\n \"\",\n \"\"\n ],\n \"keep_alive_time_seconds\": \"\",\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"custom_cpu_cores\": \"\",\n \"custom_gb_memory\": \"\",\n \"custom_disk_size\": \"\",\n \"architecture\": \"x86_64\",\n \"user_parameters\": {\n \"username\": \"\",\n \"uid\": \"\"\n },\n \"required_services\": [\n \"\",\n \"\"\n ],\n \"network_policy_id\": \"\",\n \"lifecycle\": {\n \"after_idle\": {\n \"idle_time_seconds\": \"\",\n \"on_idle\": \"shutdown\"\n },\n \"resume_triggers\": {\n \"http\": \"\",\n \"axon_event\": \"\"\n }\n }\n },\n \"capabilities\": [\n \"docker_in_docker\",\n \"unknown\"\n ],\n \"state_transitions\": [\n {\n \"status\": \"resuming\",\n \"transition_time_ms\": {}\n },\n {\n \"status\": \"running\",\n \"transition_time_ms\": {}\n }\n ],\n \"name\": \"\",\n \"initiator_type\": \"unknown\",\n \"initiator_id\": \"\",\n \"blueprint_id\": \"\",\n \"snapshot_id\": \"\",\n \"failure_reason\": \"out_of_memory\",\n \"shutdown_reason\": \"keep_alive_timeout\",\n \"tunnel\": {\n \"tunnel_key\": \"\",\n \"auth_mode\": \"open\",\n \"create_time_ms\": \"\",\n \"http_keep_alive\": \"\",\n \"wake_on_http\": \"\",\n \"auth_token\": \"\"\n },\n \"gateway_specs\": {\n \"suntd5\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"Duisfdc\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"sed44\": {\n \"gateway_config_id\": \"\",\n \"secret_id\": \"\"\n }\n },\n \"mcp_specs\": {\n \"elit_7ec\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n },\n \"ine9\": {\n \"mcp_config_id\": \"\",\n \"secret_id\": \"\"\n }\n }\n }\n ],\n \"has_more\": \"\",\n \"total_count\": \"\"\n}", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-6036d57a-35e6-4a0b-94ac-4671d41edc3d" } ], "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-71e3421f-de84-418b-bc69-b2eb0f7abe70" } ], "id": "d3665c34-6089-4a45-818a-75c06398aa47", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-d3665c34-6089-4a45-818a-75c06398aa47" } ], "id": "8194f73c-3156-4238-a14f-acbe348fdbcc", "createdAt": "2026-06-05T15:15:14.000Z", "updatedAt": "2026-06-05T15:15:14.000Z", "uid": "35240-8194f73c-3156-4238-a14f-acbe348fdbcc" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.runloop.ai" } ] }