{ "openapi": "3.0.1", "info": { "contact": {}, "description": "Daytona Toolbox API. The base URL comes from the sandbox's `toolboxProxyUrl` field (returned in sandbox DTO by the main Daytona API) plus the sandbox ID: `{toolboxProxyUrl}/{sandboxId}/{endpoint}`. Default for Daytona Cloud: `https://proxy.app.daytona.io/toolbox/{sandboxId}`.", "license": { "name": "Apache-2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0" }, "title": "Daytona Toolbox API", "version": "v0.0.0-dev" }, "servers": [ { "url": "/" } ], "paths": { "/computeruse/a11y/find": { "post": { "description": "Search the AT-SPI tree for nodes matching a role/name/state filter and return a flat list.", "operationId": "FindAccessibilityNodes", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FindAccessibilityNodesRequest" } } }, "description": "Find request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessibilityNodesResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Unavailable" } }, "summary": "Find accessibility nodes", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/a11y/node/focus": { "post": { "description": "Move keyboard focus to the AT-SPI node identified by id (bus-name:object-path).", "operationId": "FocusAccessibilityNode", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessibilityNodeRequest" } } }, "description": "Node focus request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Unavailable" } }, "summary": "Focus an accessibility node", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/a11y/node/invoke": { "post": { "description": "Call an AT-SPI Action on the node. Leave action empty to invoke the node's primary (first) action.", "operationId": "InvokeAccessibilityNode", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessibilityInvokeRequest" } } }, "description": "Invoke request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Unavailable" } }, "summary": "Invoke an action on an accessibility node", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/a11y/node/value": { "post": { "description": "Write the given value to the node via EditableText.SetTextContents or, for numeric controls, Value.CurrentValue.", "operationId": "SetAccessibilityNodeValue", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessibilitySetValueRequest" } } }, "description": "Set value request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Unavailable" } }, "summary": "Set the value of an accessibility node", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/a11y/tree": { "get": { "description": "Fetch the AT-SPI accessibility tree for the focused application, a specific PID, or all registered applications.", "operationId": "GetAccessibilityTree", "parameters": [ { "description": "Scope: focused | pid | all (default: focused)", "in": "query", "name": "scope", "schema": { "type": "string" } }, { "description": "Process ID when scope=pid", "in": "query", "name": "pid", "schema": { "type": "integer" } }, { "description": "Max tree depth (-1 unbounded, 0 root only; default -1)", "in": "query", "name": "maxDepth", "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessibilityTreeResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Unavailable" } }, "summary": "Get accessibility tree", "tags": [ "computer-use" ] } }, "/computeruse/display/info": { "get": { "description": "Get information about all available displays", "operationId": "GetDisplayInfo", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DisplayInfoResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get display information", "tags": [ "computer-use" ] } }, "/computeruse/display/windows": { "get": { "description": "Get information about all open windows", "operationId": "GetWindows", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WindowsResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get windows information", "tags": [ "computer-use" ] } }, "/computeruse/keyboard/down": { "post": { "description": "Press a key or modifier and hold it down until a matching key up call", "operationId": "KeyDown", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyboardKeyDownRequest" } } }, "description": "Key down request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Press and hold a keyboard key", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/keyboard/hotkey": { "post": { "description": "Press a hotkey combination (e.g., ctrl+c, cmd+v)", "operationId": "PressHotkey", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyboardHotkeyRequest" } } }, "description": "Hotkey press request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Press hotkey", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/keyboard/key": { "post": { "description": "Press a key with optional modifiers", "operationId": "PressKey", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyboardPressRequest" } } }, "description": "Key press request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Press key", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/keyboard/type": { "post": { "description": "Type text with optional delay between keystrokes", "operationId": "TypeText", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyboardTypeRequest" } } }, "description": "Text typing request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Type text", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/keyboard/up": { "post": { "description": "Release a key or modifier that is currently held down", "operationId": "KeyUp", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyboardKeyUpRequest" } } }, "description": "Key up request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Release a held keyboard key", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/click": { "post": { "description": "Click the mouse button at the specified coordinates", "operationId": "Click", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseClickRequest" } } }, "description": "Mouse click request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseClickResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Click mouse button", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/down": { "post": { "description": "Press and hold a mouse button, optionally moving to the specified coordinates first", "operationId": "MouseDown", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseDownRequest" } } }, "description": "Mouse button press request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MousePositionResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Press mouse button", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/drag": { "post": { "description": "Drag the mouse from start to end coordinates", "operationId": "Drag", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseDragRequest" } } }, "description": "Mouse drag request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseDragResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Drag mouse", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/move": { "post": { "description": "Move the mouse cursor to the specified coordinates", "operationId": "MoveMouse", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseMoveRequest" } } }, "description": "Mouse move request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MousePositionResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Move mouse cursor", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/position": { "get": { "description": "Get the current mouse cursor position", "operationId": "GetMousePosition", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MousePositionResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get mouse position", "tags": [ "computer-use" ] } }, "/computeruse/mouse/scroll": { "post": { "description": "Scroll the mouse wheel at the specified coordinates", "operationId": "Scroll", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseScrollRequest" } } }, "description": "Mouse scroll request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScrollResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Scroll mouse wheel", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/mouse/up": { "post": { "description": "Release a held mouse button, optionally moving to the specified coordinates first", "operationId": "MouseUp", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MouseUpRequest" } } }, "description": "Mouse button release request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MousePositionResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Release mouse button", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/process-status": { "get": { "description": "Get the status of all computer use processes", "operationId": "GetComputerUseStatus", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComputerUseStatusResponse" } } }, "description": "OK" } }, "summary": "Get computer use process status", "tags": [ "computer-use" ] } }, "/computeruse/process/{processName}/errors": { "get": { "description": "Get errors for a specific computer use process", "operationId": "GetProcessErrors", "parameters": [ { "description": "Process name to get errors for", "in": "path", "name": "processName", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessErrorsResponse" } } }, "description": "OK" } }, "summary": "Get process errors", "tags": [ "computer-use" ] } }, "/computeruse/process/{processName}/logs": { "get": { "description": "Get logs for a specific computer use process", "operationId": "GetProcessLogs", "parameters": [ { "description": "Process name to get logs for", "in": "path", "name": "processName", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessLogsResponse" } } }, "description": "OK" } }, "summary": "Get process logs", "tags": [ "computer-use" ] } }, "/computeruse/process/{processName}/restart": { "post": { "description": "Restart a specific computer use process", "operationId": "RestartProcess", "parameters": [ { "description": "Process name to restart", "in": "path", "name": "processName", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessRestartResponse" } } }, "description": "OK" } }, "summary": "Restart specific process", "tags": [ "computer-use" ] } }, "/computeruse/process/{processName}/status": { "get": { "description": "Check if a specific computer use process is running", "operationId": "GetProcessStatus", "parameters": [ { "description": "Process name to check", "in": "path", "name": "processName", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessStatusResponse" } } }, "description": "OK" } }, "summary": "Get specific process status", "tags": [ "computer-use" ] } }, "/computeruse/recordings": { "get": { "description": "Get a list of all recordings (active and completed)", "operationId": "ListRecordings", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListRecordingsResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "List all recordings", "tags": [ "computer-use" ] } }, "/computeruse/recordings/start": { "post": { "description": "Start a new screen recording session", "operationId": "StartRecording", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartRecordingRequest" } } }, "description": "Recording options", "required": false }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Recording" } } }, "description": "Created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Start a new recording", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/recordings/stop": { "post": { "description": "Stop an active screen recording session", "operationId": "StopRecording", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StopRecordingRequest" } } }, "description": "Recording ID to stop", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Recording" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Stop a recording", "tags": [ "computer-use" ], "x-codegen-request-body-name": "request" } }, "/computeruse/recordings/{id}": { "delete": { "description": "Delete a recording file by ID", "operationId": "DeleteRecording", "parameters": [ { "description": "Recording ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "content": {}, "description": "No Content" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Delete a recording", "tags": [ "computer-use" ] }, "get": { "description": "Get details of a specific recording by ID", "operationId": "GetRecording", "parameters": [ { "description": "Recording ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Recording" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get recording details", "tags": [ "computer-use" ] } }, "/computeruse/recordings/{id}/download": { "get": { "description": "Download a recording by providing its ID", "operationId": "DownloadRecording", "parameters": [ { "description": "Recording ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/octet-stream": { "schema": { "format": "binary", "type": "string" } } }, "description": "OK" }, "400": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Download a recording", "tags": [ "computer-use" ] } }, "/computeruse/screenshot": { "get": { "description": "Take a screenshot of the entire screen", "operationId": "TakeScreenshot", "parameters": [ { "description": "Whether to show cursor in screenshot", "in": "query", "name": "showCursor", "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Take a screenshot", "tags": [ "computer-use" ] } }, "/computeruse/screenshot/compressed": { "get": { "description": "Take a compressed screenshot of the entire screen", "operationId": "TakeCompressedScreenshot", "parameters": [ { "description": "Whether to show cursor in screenshot", "in": "query", "name": "showCursor", "schema": { "type": "boolean" } }, { "description": "Image format (png or jpeg)", "in": "query", "name": "format", "schema": { "type": "string" } }, { "description": "JPEG quality (1-100)", "in": "query", "name": "quality", "schema": { "type": "integer" } }, { "description": "Scale factor (0.1-1.0)", "in": "query", "name": "scale", "schema": { "type": "number" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Take a compressed screenshot", "tags": [ "computer-use" ] } }, "/computeruse/screenshot/region": { "get": { "description": "Take a screenshot of a specific region of the screen", "operationId": "TakeRegionScreenshot", "parameters": [ { "description": "X coordinate of the region", "in": "query", "name": "x", "required": true, "schema": { "type": "integer" } }, { "description": "Y coordinate of the region", "in": "query", "name": "y", "required": true, "schema": { "type": "integer" } }, { "description": "Width of the region", "in": "query", "name": "width", "required": true, "schema": { "type": "integer" } }, { "description": "Height of the region", "in": "query", "name": "height", "required": true, "schema": { "type": "integer" } }, { "description": "Whether to show cursor in screenshot", "in": "query", "name": "showCursor", "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Take a region screenshot", "tags": [ "computer-use" ] } }, "/computeruse/screenshot/region/compressed": { "get": { "description": "Take a compressed screenshot of a specific region of the screen", "operationId": "TakeCompressedRegionScreenshot", "parameters": [ { "description": "X coordinate of the region", "in": "query", "name": "x", "required": true, "schema": { "type": "integer" } }, { "description": "Y coordinate of the region", "in": "query", "name": "y", "required": true, "schema": { "type": "integer" } }, { "description": "Width of the region", "in": "query", "name": "width", "required": true, "schema": { "type": "integer" } }, { "description": "Height of the region", "in": "query", "name": "height", "required": true, "schema": { "type": "integer" } }, { "description": "Whether to show cursor in screenshot", "in": "query", "name": "showCursor", "schema": { "type": "boolean" } }, { "description": "Image format (png or jpeg)", "in": "query", "name": "format", "schema": { "type": "string" } }, { "description": "JPEG quality (1-100)", "in": "query", "name": "quality", "schema": { "type": "integer" } }, { "description": "Scale factor (0.1-1.0)", "in": "query", "name": "scale", "schema": { "type": "number" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Take a compressed region screenshot", "tags": [ "computer-use" ] } }, "/computeruse/start": { "post": { "description": "Start all computer use processes and return their status", "operationId": "StartComputerUse", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComputerUseStartResponse" } } }, "description": "OK" } }, "summary": "Start computer use processes", "tags": [ "computer-use" ] } }, "/computeruse/status": { "get": { "description": "Get the current status of the computer use system", "operationId": "GetComputerUseSystemStatus", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComputerUseStatusResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get computer use status", "tags": [ "computer-use" ] } }, "/computeruse/stop": { "post": { "description": "Stop all computer use processes and return their status", "operationId": "StopComputerUse", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComputerUseStopResponse" } } }, "description": "OK" } }, "summary": "Stop computer use processes", "tags": [ "computer-use" ] } }, "/env": { "post": { "description": "Update the daemon's process environment. Newly spawned processes, sessions and PTYs inherit the change; already-running processes keep their environment.", "operationId": "UpdateEnv", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UpdateEnvRequest" } } }, "description": "Environment update request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Update process environment", "tags": [ "server" ], "x-codegen-request-body-name": "request" } }, "/files": { "delete": { "description": "Delete a file or directory at the specified path", "operationId": "DeleteFile", "parameters": [ { "description": "File or directory path to delete", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } }, { "description": "Enable recursive deletion for directories", "in": "query", "name": "recursive", "schema": { "type": "boolean" } } ], "responses": { "204": { "content": {}, "description": "No Content" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Delete a file or directory", "tags": [ "file-system" ] }, "get": { "description": "List files and directories in the specified path. Use the optional depth\nparameter to list recursively: depth=1 (default) lists the directory's\nentries, depth=2 also includes their children, and so on.", "operationId": "ListFiles", "parameters": [ { "description": "Directory path to list (defaults to working directory)", "in": "query", "name": "path", "schema": { "type": "string" } }, { "description": "How many levels deep to list (default: 1, must be >= 1)", "in": "query", "name": "depth", "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/FileInfo" }, "type": "array" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "List files and directories", "tags": [ "file-system" ] } }, "/files/bulk-download": { "post": { "description": "Download multiple files by providing their paths. Successful files are returned as multipart parts named `file`. Per-file failures are returned as multipart parts named `error` with JSON payloads shaped like ErrorResponse.", "operationId": "DownloadFiles", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilesDownloadRequest" } } }, "description": "Paths of files to download", "required": true }, "responses": { "200": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/gin.H" } } }, "description": "Multipart response with file parts and JSON error parts" }, "400": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Download multiple files", "tags": [ "file-system" ], "x-codegen-request-body-name": "downloadFiles" } }, "/files/bulk-upload": { "post": { "description": "Upload multiple files with their destination paths", "operationId": "UploadFiles", "responses": { "200": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UploadFilesResponse" } } }, "description": "OK" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UploadFilesResponse" } } }, "description": "Bad Request" } }, "summary": "Upload multiple files", "tags": [ "file-system" ] } }, "/files/download": { "get": { "description": "Download a file by providing its path", "operationId": "DownloadFile", "parameters": [ { "description": "File path to download", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/octet-stream": { "schema": { "format": "binary", "type": "string" } } }, "description": "OK" }, "400": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/octet-stream": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Download a file", "tags": [ "file-system" ] } }, "/files/find": { "get": { "description": "Search for text pattern within files in a directory", "operationId": "FindInFiles", "parameters": [ { "description": "Directory path to search in", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } }, { "description": "Text pattern to search for", "in": "query", "name": "pattern", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Match" }, "type": "array" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Find text in files", "tags": [ "file-system" ] } }, "/files/folder": { "post": { "description": "Create a folder with the specified path and optional permissions", "operationId": "CreateFolder", "parameters": [ { "description": "Folder path to create", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } }, { "description": "Octal permission mode (default: 0755)", "in": "query", "name": "mode", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "content": {}, "description": "Created" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Create a folder", "tags": [ "file-system" ] } }, "/files/info": { "get": { "description": "Get detailed information about a file or directory", "operationId": "GetFileInfo", "parameters": [ { "description": "File or directory path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileInfo" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Get file information", "tags": [ "file-system" ] } }, "/files/move": { "post": { "description": "Move or rename a file or directory from source to destination", "operationId": "MoveFile", "parameters": [ { "description": "Source file or directory path", "in": "query", "name": "source", "required": true, "schema": { "type": "string" } }, { "description": "Destination file or directory path", "in": "query", "name": "destination", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" } }, "summary": "Move or rename file/directory", "tags": [ "file-system" ] } }, "/files/permissions": { "post": { "description": "Set file permissions, ownership, and group for a file or directory", "operationId": "SetFilePermissions", "parameters": [ { "description": "File or directory path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } }, { "description": "Owner (username or UID)", "in": "query", "name": "owner", "schema": { "type": "string" } }, { "description": "Group (group name or GID)", "in": "query", "name": "group", "schema": { "type": "string" } }, { "description": "File mode in octal format (e.g., 0755)", "in": "query", "name": "mode", "schema": { "type": "string" } } ], "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Set file permissions", "tags": [ "file-system" ] } }, "/files/replace": { "post": { "description": "Replace text pattern with new value in multiple files", "operationId": "ReplaceInFiles", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaceRequest" } } }, "description": "Replace request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ReplaceResult" }, "type": "array" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Replace text in files", "tags": [ "file-system" ], "x-codegen-request-body-name": "request" } }, "/files/search": { "get": { "description": "Search for files matching a specific pattern in a directory", "operationId": "SearchFiles", "parameters": [ { "description": "Directory path to search in", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } }, { "description": "File pattern to match (e.g., *.txt, *.go)", "in": "query", "name": "pattern", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchFilesResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Search files by pattern", "tags": [ "file-system" ] } }, "/files/upload-v2": { "post": { "description": "Upload a file to the specified path. Accepts either multipart/form-data\n(field \"file\") or a raw request body (e.g. application/octet-stream).\nParent directories are created if missing; an existing file is overwritten.", "operationId": "UploadFile", "parameters": [ { "description": "Destination path for the uploaded file", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/UploadFile_request" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadedFile" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Upload a file", "tags": [ "file-system" ] } }, "/git/add": { "post": { "description": "Add files to the Git staging area", "operationId": "AddFiles", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitAddRequest" } } }, "description": "Add files request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Add files to Git staging", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/branches": { "delete": { "description": "Delete a branch from the Git repository", "operationId": "DeleteBranch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitDeleteBranchRequest" } } }, "description": "Delete branch request", "required": true }, "responses": { "204": { "content": {}, "description": "No Content" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Delete a branch", "tags": [ "git" ], "x-codegen-request-body-name": "request" }, "get": { "description": "Get a list of all branches in the Git repository", "operationId": "ListBranches", "parameters": [ { "description": "Repository path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBranchResponse" } } }, "description": "OK" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "List branches", "tags": [ "git" ] }, "post": { "description": "Create a new branch in the Git repository", "operationId": "CreateBranch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitBranchRequest" } } }, "description": "Create branch request", "required": true }, "responses": { "201": { "content": {}, "description": "Created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Create a new branch", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/checkout": { "post": { "description": "Switch to a different branch or commit in the Git repository", "operationId": "CheckoutBranch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitCheckoutRequest" } } }, "description": "Checkout request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Checkout branch or commit", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/clone": { "post": { "description": "Clone a Git repository to the specified path. Defaults to strict TLS verification; set insecure_skip_tls=true to skip verification for self-signed or private-CA Git servers.", "operationId": "CloneRepository", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitCloneRequest" } } }, "description": "Clone repository request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Clone a Git repository", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/commit": { "post": { "description": "Commit staged changes to the Git repository", "operationId": "CommitChanges", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitCommitRequest" } } }, "description": "Commit request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitCommitResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Commit changes", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/config": { "get": { "description": "Get a Git config value at the given scope (null when unset)", "operationId": "GetGitConfig", "parameters": [ { "description": "Config key (e.g. user.name)", "in": "query", "name": "key", "required": true, "schema": { "type": "string" } }, { "description": "Repository path (required for local scope)", "in": "query", "name": "path", "schema": { "type": "string" } }, { "description": "Config scope: global (default), local or system", "in": "query", "name": "scope", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitConfigResponse" } } }, "description": "OK" } }, "summary": "Get a Git config value", "tags": [ "git" ] }, "post": { "description": "Set a Git config key/value at the given scope", "operationId": "SetGitConfig", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitSetConfigRequest" } } }, "description": "Set config request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" } }, "summary": "Set a Git config value", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/config/user": { "post": { "description": "Configure the Git user name and email at the given scope", "operationId": "ConfigureUser", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitConfigureUserRequest" } } }, "description": "Configure user request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" } }, "summary": "Configure Git user", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/credentials": { "post": { "description": "Persist Git credentials globally via the credential store. Stores the password in plaintext on disk.", "operationId": "Authenticate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitAuthenticateRequest" } } }, "description": "Authenticate request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" } }, "summary": "Authenticate Git", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/history": { "get": { "description": "Get the commit history of the Git repository", "operationId": "GetCommitHistory", "parameters": [ { "description": "Repository path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/GitCommitInfo" }, "type": "array" } } }, "description": "OK" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get commit history", "tags": [ "git" ] } }, "/git/init": { "post": { "description": "Initialize a new Git repository at the specified path", "operationId": "InitRepository", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitInitRequest" } } }, "description": "Init repository request", "required": true }, "responses": { "201": { "content": {}, "description": "Created" } }, "summary": "Initialize a Git repository", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/pull": { "post": { "description": "Pull changes from the remote Git repository", "operationId": "PullChanges", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitPullRequest" } } }, "description": "Pull request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Pull changes from remote", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/push": { "post": { "description": "Push local changes to the remote Git repository", "operationId": "PushChanges", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitPushRequest" } } }, "description": "Push request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Push changes to remote", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/remotes": { "get": { "description": "List the remotes configured in the Git repository", "operationId": "ListRemotes", "parameters": [ { "description": "Repository path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListRemotesResponse" } } }, "description": "OK" } }, "summary": "List remotes", "tags": [ "git" ] }, "post": { "description": "Add (or overwrite) a remote in the Git repository", "operationId": "AddRemote", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitAddRemoteRequest" } } }, "description": "Add remote request", "required": true }, "responses": { "201": { "content": {}, "description": "Created" } }, "summary": "Add a remote", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/reset": { "post": { "description": "Reset the current HEAD to the specified state", "operationId": "ResetChanges", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitResetRequest" } } }, "description": "Reset request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" } }, "summary": "Reset repository", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/restore": { "post": { "description": "Restore working tree files or unstage changes", "operationId": "RestoreFiles", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitRestoreRequest" } } }, "description": "Restore request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" } }, "summary": "Restore files", "tags": [ "git" ], "x-codegen-request-body-name": "request" } }, "/git/status": { "get": { "description": "Get the Git status of the repository at the specified path", "operationId": "GetStatus", "parameters": [ { "description": "Repository path", "in": "query", "name": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GitStatus" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get Git status", "tags": [ "git" ] } }, "/init": { "post": { "description": "Set the auth token and initialize telemetry for the toolbox server", "operationId": "Initialize", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/InitializeRequest" } } }, "description": "Initialization request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object" } } }, "description": "OK" } }, "summary": "Initialize toolbox server", "tags": [ "server" ], "x-codegen-request-body-name": "request" } }, "/lsp/completions": { "post": { "description": "Get code completion suggestions from the LSP server", "operationId": "Completions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LspCompletionParams" } } }, "description": "Completion request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompletionList" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Get code completions", "tags": [ "lsp" ], "x-codegen-request-body-name": "request" } }, "/lsp/did-close": { "post": { "description": "Notify the LSP server that a document has been closed", "operationId": "DidClose", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LspDocumentRequest" } } }, "description": "Document request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Notify document closed", "tags": [ "lsp" ], "x-codegen-request-body-name": "request" } }, "/lsp/did-open": { "post": { "description": "Notify the LSP server that a document has been opened", "operationId": "DidOpen", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LspDocumentRequest" } } }, "description": "Document request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Notify document opened", "tags": [ "lsp" ], "x-codegen-request-body-name": "request" } }, "/lsp/document-symbols": { "get": { "description": "Get symbols (functions, classes, etc.) from a document", "operationId": "DocumentSymbols", "parameters": [ { "description": "Language ID (e.g., python, typescript)", "in": "query", "name": "languageId", "required": true, "schema": { "type": "string" } }, { "description": "Path to project", "in": "query", "name": "pathToProject", "required": true, "schema": { "type": "string" } }, { "description": "Document URI", "in": "query", "name": "uri", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/LspSymbol" }, "type": "array" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Get document symbols", "tags": [ "lsp" ] } }, "/lsp/start": { "post": { "description": "Start a Language Server Protocol server for the specified language", "operationId": "Start", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LspServerRequest" } } }, "description": "LSP server request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Start LSP server", "tags": [ "lsp" ], "x-codegen-request-body-name": "request" } }, "/lsp/stop": { "post": { "description": "Stop a Language Server Protocol server", "operationId": "Stop", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LspServerRequest" } } }, "description": "LSP server request", "required": true }, "responses": { "200": { "content": {}, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Stop LSP server", "tags": [ "lsp" ], "x-codegen-request-body-name": "request" } }, "/lsp/workspacesymbols": { "get": { "description": "Search for symbols across the entire workspace", "operationId": "WorkspaceSymbols", "parameters": [ { "description": "Search query", "in": "query", "name": "query", "required": true, "schema": { "type": "string" } }, { "description": "Language ID (e.g., python, typescript)", "in": "query", "name": "languageId", "required": true, "schema": { "type": "string" } }, { "description": "Path to project", "in": "query", "name": "pathToProject", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/LspSymbol" }, "type": "array" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Get workspace symbols", "tags": [ "lsp" ] } }, "/port": { "get": { "description": "Get a list of all currently active ports", "operationId": "GetPorts", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PortList" } } }, "description": "OK" } }, "summary": "Get active ports", "tags": [ "port" ] } }, "/port/{port}/in-use": { "get": { "description": "Check if a specific port is currently in use", "operationId": "IsPortInUse", "parameters": [ { "description": "Port number (3000-9999)", "in": "path", "name": "port", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsPortInUseResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Check if port is in use", "tags": [ "port" ] } }, "/process/code-run": { "post": { "description": "Execute Python, JavaScript, or TypeScript code and return output, exit code, and artifacts", "operationId": "CodeRun", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CodeRunRequest" } } }, "description": "Code execution request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CodeRunResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "408": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Timeout" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Execute code", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/execute": { "post": { "description": "Execute a shell command and return the output and exit code", "operationId": "ExecuteCommand", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecuteRequest" } } }, "description": "Command execution request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecuteResponse" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "408": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Timeout" } }, "summary": "Execute a command", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/interpreter/context": { "get": { "description": "Returns information about all user-created interpreter contexts (excludes default context)", "operationId": "ListInterpreterContexts", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListContextsResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "List all user-created interpreter contexts", "tags": [ "interpreter" ] }, "post": { "description": "Creates a new isolated interpreter context with optional working directory and language", "operationId": "CreateInterpreterContext", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateContextRequest" } } }, "description": "Context configuration", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterpreterContext" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Create a new interpreter context", "tags": [ "interpreter" ], "x-codegen-request-body-name": "request" } }, "/process/interpreter/context/{id}": { "delete": { "description": "Deletes an interpreter context and shuts down its worker process", "operationId": "DeleteInterpreterContext", "parameters": [ { "description": "Context ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Delete an interpreter context", "tags": [ "interpreter" ] } }, "/process/interpreter/execute": { "get": { "description": "Executes code in a specified context (or default context if not specified) via WebSocket streaming", "operationId": "ExecuteInterpreterCode", "responses": { "101": { "content": { "application/json": { "schema": { "type": "string" } } }, "description": "Switching Protocols", "headers": { "Connection": { "description": "Upgrade", "schema": { "type": "string" } }, "Upgrade": { "description": "websocket", "schema": { "type": "string" } } } } }, "summary": "Execute code in an interpreter context", "tags": [ "interpreter" ] } }, "/process/pty": { "get": { "description": "Get a list of all active pseudo-terminal sessions", "operationId": "ListPtySessions", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyListResponse" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "List all PTY sessions", "tags": [ "process" ] }, "post": { "description": "Create a new pseudo-terminal session with specified configuration", "operationId": "CreatePtySession", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyCreateRequest" } } }, "description": "PTY session creation request", "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyCreateResponse" } } }, "description": "Created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Create a new PTY session", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/pty/{sessionId}": { "delete": { "description": "Delete a pseudo-terminal session and terminate its process", "operationId": "DeletePtySession", "parameters": [ { "description": "PTY session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/gin.H" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Delete a PTY session", "tags": [ "process" ] }, "get": { "description": "Get detailed information about a specific pseudo-terminal session", "operationId": "GetPtySession", "parameters": [ { "description": "PTY session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtySessionInfo" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" } }, "summary": "Get PTY session information", "tags": [ "process" ] } }, "/process/pty/{sessionId}/connect": { "get": { "description": "Establish a WebSocket connection to interact with a pseudo-terminal session", "operationId": "ConnectPtySession", "parameters": [ { "description": "PTY session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "responses": { "101": { "content": {}, "description": "Switching Protocols - WebSocket connection established" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" } }, "summary": "Connect to PTY session via WebSocket", "tags": [ "process" ] } }, "/process/pty/{sessionId}/resize": { "post": { "description": "Resize the terminal dimensions of a pseudo-terminal session", "operationId": "ResizePtySession", "parameters": [ { "description": "PTY session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyResizeRequest" } } }, "description": "Resize request with new dimensions", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtySessionInfo" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Gone" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Resize a PTY session", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/session": { "get": { "description": "Get a list of all active shell sessions", "operationId": "ListSessions", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Session" }, "type": "array" } } }, "description": "OK" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "List all sessions", "tags": [ "process" ] }, "post": { "description": "Create a new shell session for command execution", "operationId": "CreateSession", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSessionRequest" } } }, "description": "Session creation request", "required": true }, "responses": { "201": { "content": {}, "description": "Created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Create a new session", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/session/entrypoint": { "get": { "description": "Get details of an entrypoint session including its commands", "operationId": "GetEntrypointSession", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" } } }, "description": "OK" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get entrypoint session details", "tags": [ "process" ] } }, "/process/session/entrypoint/logs": { "get": { "description": "Get logs for a sandbox entrypoint session. Returns JSON with separated stdout/stderr for SDK >= 0.161.0, plain text otherwise. Supports WebSocket streaming.", "operationId": "GetEntrypointLogs", "parameters": [ { "description": "Follow logs in real-time (WebSocket only)", "in": "query", "name": "follow", "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCommandLogsResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/SessionCommandLogsResponse" } } }, "description": "Entrypoint log content" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get entrypoint logs", "tags": [ "process" ] } }, "/process/session/{sessionId}": { "delete": { "description": "Delete an existing shell session", "operationId": "DeleteSession", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "content": {}, "description": "No Content" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Delete a session", "tags": [ "process" ] }, "get": { "description": "Get details of a specific session including its commands", "operationId": "GetSession", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" } } }, "description": "OK" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get session details", "tags": [ "process" ] } }, "/process/session/{sessionId}/command/{commandId}": { "get": { "description": "Get details of a specific command within a session", "operationId": "GetSessionCommand", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } }, { "description": "Command ID", "in": "path", "name": "commandId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Command" } } }, "description": "OK" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get session command details", "tags": [ "process" ] } }, "/process/session/{sessionId}/command/{commandId}/input": { "post": { "description": "Send input data to a running command in a session for interactive execution", "operationId": "SendInput", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } }, { "description": "Command ID", "in": "path", "name": "commandId", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionSendInputRequest" } } }, "description": "Input send request", "required": true }, "responses": { "204": { "content": {}, "description": "No Content" }, "400": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "410": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Gone" }, "500": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Send input to command", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/process/session/{sessionId}/command/{commandId}/logs": { "get": { "description": "Get logs for a specific command within a session. Returns JSON with separated stdout/stderr for SDK >= 0.167.0, plain text otherwise. Supports WebSocket streaming.", "operationId": "GetSessionCommandLogs", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } }, { "description": "Command ID", "in": "path", "name": "commandId", "required": true, "schema": { "type": "string" } }, { "description": "Follow logs in real-time (WebSocket only)", "in": "query", "name": "follow", "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCommandLogsResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/SessionCommandLogsResponse" } } }, "description": "Log content (JSON for new SDKs, plain text for old SDKs)" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Get session command logs", "tags": [ "process" ] } }, "/process/session/{sessionId}/exec": { "post": { "description": "Execute a command within an existing shell session", "operationId": "SessionExecuteCommand", "parameters": [ { "description": "Session ID", "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionExecuteRequest" } } }, "description": "Command execution request", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionExecuteResponse" } } }, "description": "OK" }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionExecuteResponse" } } }, "description": "Accepted" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Gone" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Execute command in session", "tags": [ "process" ], "x-codegen-request-body-name": "request" } }, "/system/metrics": { "get": { "description": "Latest CPU/memory/disk usage snapshot for the sandbox. cpuUsedPct is the\naverage CPU usage as a percentage of the CPU limit over the last sample\nwindow (0 until the first sample completes). Byte fields are in bytes.", "operationId": "GetSystemMetrics", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SystemMetrics" } } }, "description": "OK" } }, "summary": "Get sandbox resource metrics", "tags": [ "system" ] } }, "/user-home-dir": { "get": { "description": "Get the current user home directory path.", "operationId": "GetUserHomeDir", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserHomeDirResponse" } } }, "description": "OK" } }, "summary": "Get user home directory", "tags": [ "info" ] } }, "/version": { "get": { "description": "Get the current daemon version", "operationId": "GetVersion", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object" } } }, "description": "OK" } }, "summary": "Get version", "tags": [ "info" ] } }, "/work-dir": { "get": { "description": "Get the current working directory path. This is default directory used for running commands.", "operationId": "GetWorkDir", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkDirResponse" } } }, "description": "OK" } }, "summary": "Get working directory", "tags": [ "info" ] } } }, "components": { "schemas": { "AccessibilityBounds": { "example": { "width": 6, "x": 1, "y": 5, "height": 0 }, "properties": { "height": { "type": "integer" }, "width": { "type": "integer" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "AccessibilityInvokeRequest": { "example": { "action": "action", "id": "id" }, "properties": { "action": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "AccessibilityNodeRequest": { "example": { "id": "id" }, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "AccessibilityNodesResponse": { "example": { "truncated": true, "matches": [ { "role": "role", "children": [ null, null ], "bounds": { "width": 6, "x": 1, "y": 5, "height": 0 }, "name": "name", "description": "description", "id": "id", "actions": [ "actions", "actions" ], "states": [ "states", "states" ] }, { "role": "role", "children": [ null, null ], "bounds": { "width": 6, "x": 1, "y": 5, "height": 0 }, "name": "name", "description": "description", "id": "id", "actions": [ "actions", "actions" ], "states": [ "states", "states" ] } ] }, "properties": { "matches": { "items": { "$ref": "#/components/schemas/computeruse.AccessibilityNode" }, "type": "array" }, "truncated": { "type": "boolean" } }, "type": "object" }, "AccessibilitySetValueRequest": { "example": { "id": "id", "value": "value" }, "properties": { "id": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "AccessibilityTreeResponse": { "example": { "root": { "role": "role", "children": [ null, null ], "bounds": { "width": 6, "x": 1, "y": 5, "height": 0 }, "name": "name", "description": "description", "id": "id", "actions": [ "actions", "actions" ], "states": [ "states", "states" ] }, "truncated": true }, "properties": { "root": { "$ref": "#/components/schemas/computeruse.AccessibilityNode" }, "truncated": { "type": "boolean" } }, "type": "object" }, "Chart": { "example": { "y_ticks": [ 4.145608029883936, 4.145608029883936 ], "x_ticks": [ 2.027123023002322, 2.027123023002322 ], "y_label": "y_label", "y_tick_labels": [ "y_tick_labels", "y_tick_labels" ], "y_scale": "y_scale", "x_tick_labels": [ "x_tick_labels", "x_tick_labels" ], "elements": [ { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 } ], "png": "png", "x_scale": "x_scale", "x_label": "x_label", "title": "title", "type": "type" }, "properties": { "elements": { "items": { "$ref": "#/components/schemas/ChartElement" }, "type": "array" }, "png": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "x_label": { "type": "string" }, "x_scale": { "type": "string" }, "x_tick_labels": { "items": { "type": "string" }, "type": "array" }, "x_ticks": { "items": { "type": "number" }, "type": "array" }, "y_label": { "type": "string" }, "y_scale": { "type": "string" }, "y_tick_labels": { "items": { "type": "string" }, "type": "array" }, "y_ticks": { "items": { "type": "number" }, "type": "array" } }, "type": "object" }, "ChartElement": { "example": { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, "properties": { "angle": { "type": "number" }, "first_quartile": { "type": "number" }, "group": { "type": "string" }, "label": { "type": "string" }, "max": { "type": "number" }, "median": { "type": "number" }, "min": { "type": "number" }, "outliers": { "items": { "type": "number" }, "type": "array" }, "png": { "type": "string" }, "points": { "items": { "items": { "type": "number" }, "type": "array" }, "type": "array" }, "radius": { "type": "number" }, "third_quartile": { "type": "number" }, "title": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "x_label": { "type": "string" }, "y_label": { "type": "string" } }, "type": "object" }, "CodeRunArtifacts": { "example": { "charts": [ { "y_ticks": [ 4.145608029883936, 4.145608029883936 ], "x_ticks": [ 2.027123023002322, 2.027123023002322 ], "y_label": "y_label", "y_tick_labels": [ "y_tick_labels", "y_tick_labels" ], "y_scale": "y_scale", "x_tick_labels": [ "x_tick_labels", "x_tick_labels" ], "elements": [ { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 } ], "png": "png", "x_scale": "x_scale", "x_label": "x_label", "title": "title", "type": "type" }, { "y_ticks": [ 4.145608029883936, 4.145608029883936 ], "x_ticks": [ 2.027123023002322, 2.027123023002322 ], "y_label": "y_label", "y_tick_labels": [ "y_tick_labels", "y_tick_labels" ], "y_scale": "y_scale", "x_tick_labels": [ "x_tick_labels", "x_tick_labels" ], "elements": [ { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 } ], "png": "png", "x_scale": "x_scale", "x_label": "x_label", "title": "title", "type": "type" } ] }, "properties": { "charts": { "items": { "$ref": "#/components/schemas/Chart" }, "type": "array" } }, "type": "object" }, "CodeRunRequest": { "example": { "code": "code", "envs": { "key": "envs" }, "language": "language", "argv": [ "argv", "argv" ], "timeout": 0 }, "properties": { "argv": { "items": { "type": "string" }, "type": "array" }, "code": { "type": "string" }, "envs": { "additionalProperties": { "type": "string" }, "type": "object" }, "language": { "description": "python, javascript, typescript", "type": "string" }, "timeout": { "type": "integer" } }, "required": [ "code", "language" ], "type": "object" }, "CodeRunResponse": { "example": { "result": "result", "exitCode": 7, "artifacts": { "charts": [ { "y_ticks": [ 4.145608029883936, 4.145608029883936 ], "x_ticks": [ 2.027123023002322, 2.027123023002322 ], "y_label": "y_label", "y_tick_labels": [ "y_tick_labels", "y_tick_labels" ], "y_scale": "y_scale", "x_tick_labels": [ "x_tick_labels", "x_tick_labels" ], "elements": [ { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 } ], "png": "png", "x_scale": "x_scale", "x_label": "x_label", "title": "title", "type": "type" }, { "y_ticks": [ 4.145608029883936, 4.145608029883936 ], "x_ticks": [ 2.027123023002322, 2.027123023002322 ], "y_label": "y_label", "y_tick_labels": [ "y_tick_labels", "y_tick_labels" ], "y_scale": "y_scale", "x_tick_labels": [ "x_tick_labels", "x_tick_labels" ], "elements": [ { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 }, { "y_label": "y_label", "max": 1.4658129805029452, "png": "png", "x_label": "x_label", "label": "label", "outliers": [ 2.3021358869347655, 2.3021358869347655 ], "title": "title", "type": "type", "points": [ [ 7.061401241503109, 7.061401241503109 ], [ 7.061401241503109, 7.061401241503109 ] ], "first_quartile": 6.027456183070403, "min": 5.637376656633329, "median": 5.962133916683182, "angle": 0.8008281904610115, "radius": 9.301444243932576, "value": "value", "group": "group", "third_quartile": 3.616076749251911 } ], "png": "png", "x_scale": "x_scale", "x_label": "x_label", "title": "title", "type": "type" } ] } }, "properties": { "artifacts": { "$ref": "#/components/schemas/CodeRunArtifacts" }, "exitCode": { "type": "integer" }, "result": { "type": "string" } }, "type": "object" }, "Command": { "example": { "exitCode": 0, "id": "id", "command": "command" }, "properties": { "command": { "type": "string" }, "exitCode": { "type": "integer" }, "id": { "type": "string" } }, "required": [ "command", "id" ], "type": "object" }, "CompletionContext": { "example": { "triggerCharacter": "triggerCharacter", "triggerKind": 0 }, "properties": { "triggerCharacter": { "type": "string" }, "triggerKind": { "type": "integer" } }, "required": [ "triggerKind" ], "type": "object" }, "CompletionItem": { "example": { "insertText": "insertText", "kind": 0, "sortText": "sortText", "documentation": "{}", "detail": "detail", "filterText": "filterText", "label": "label" }, "properties": { "detail": { "type": "string" }, "documentation": { "type": "object" }, "filterText": { "type": "string" }, "insertText": { "type": "string" }, "kind": { "type": "integer" }, "label": { "type": "string" }, "sortText": { "type": "string" } }, "required": [ "label" ], "type": "object" }, "CompletionList": { "example": { "items": [ { "insertText": "insertText", "kind": 0, "sortText": "sortText", "documentation": "{}", "detail": "detail", "filterText": "filterText", "label": "label" }, { "insertText": "insertText", "kind": 0, "sortText": "sortText", "documentation": "{}", "detail": "detail", "filterText": "filterText", "label": "label" } ], "isIncomplete": true }, "properties": { "isIncomplete": { "type": "boolean" }, "items": { "items": { "$ref": "#/components/schemas/CompletionItem" }, "type": "array" } }, "required": [ "isIncomplete", "items" ], "type": "object" }, "ComputerUseStartResponse": { "example": { "message": "message", "status": { "key": { "autoRestart": true, "running": true, "pid": 0, "priority": 6 } } }, "properties": { "message": { "type": "string" }, "status": { "additionalProperties": { "$ref": "#/components/schemas/ProcessStatus" }, "type": "object" } }, "type": "object" }, "ComputerUseStatusResponse": { "example": { "status": "status" }, "properties": { "status": { "type": "string" } }, "type": "object" }, "ComputerUseStopResponse": { "example": { "message": "message", "status": { "key": { "autoRestart": true, "running": true, "pid": 0, "priority": 6 } } }, "properties": { "message": { "type": "string" }, "status": { "additionalProperties": { "$ref": "#/components/schemas/ProcessStatus" }, "type": "object" } }, "type": "object" }, "CreateContextRequest": { "example": { "cwd": "cwd", "language": "language" }, "properties": { "cwd": { "type": "string" }, "language": { "type": "string" } }, "type": "object" }, "CreateSessionRequest": { "example": { "sessionId": "sessionId" }, "properties": { "sessionId": { "type": "string" } }, "required": [ "sessionId" ], "type": "object" }, "DaemonErrorCode": { "enum": [ "GIT_AUTH_FAILED", "GIT_REPO_NOT_FOUND", "GIT_BRANCH_NOT_FOUND", "GIT_BRANCH_EXISTS", "GIT_PUSH_REJECTED", "GIT_DIRTY_WORKTREE", "GIT_MERGE_CONFLICT", "GIT_TRANSPORT_FAILED", "GIT_REMOTE_REJECTED", "FILE_NOT_FOUND", "FILE_ACCESS_DENIED", "INVALID_FILE_PATH", "FILE_READ_FAILED", "LSP_SERVER_NOT_INITIALIZED", "PROCESS_EXECUTION_TIMEOUT", "PROCESS_NOT_FOUND", "SESSION_ENDED", "COMMAND_ALREADY_COMPLETED", "A11Y_UNAVAILABLE", "RECORDING_STILL_ACTIVE", "RECORDING_FFMPEG_NOT_FOUND", "BAD_REQUEST", "INVALID_REQUEST_BODY", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "REQUEST_TIMEOUT", "GONE", "UNPROCESSABLE_ENTITY", "INTERNAL_SERVER_ERROR" ], "type": "string", "x-enum-varnames": [ "CodeGitAuthFailed", "CodeGitRepoNotFound", "CodeGitBranchNotFound", "CodeGitBranchExists", "CodeGitPushRejected", "CodeGitDirtyWorktree", "CodeGitMergeConflict", "CodeGitTransportFailed", "CodeGitRemoteRejected", "CodeFileNotFound", "CodeFileAccessDenied", "CodeInvalidFilePath", "CodeFileReadFailed", "CodeLspServerNotInitialized", "CodeProcessExecutionTimeout", "CodeProcessNotFound", "CodeSessionEnded", "CodeCommandAlreadyCompleted", "CodeA11yUnavailable", "CodeRecordingStillActive", "CodeRecordingFfmpegNotFound", "CodeBadRequest", "CodeInvalidRequestBody", "CodeUnauthorized", "CodeForbidden", "CodeNotFound", "CodeConflict", "CodeRequestTimeout", "CodeGone", "CodeUnprocessableEntity", "CodeInternalServerError" ] }, "DisplayInfo": { "example": { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "height": 0 }, "properties": { "height": { "type": "integer" }, "id": { "type": "integer" }, "isActive": { "type": "boolean" }, "width": { "type": "integer" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "DisplayInfoResponse": { "example": { "displays": [ { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "height": 0 }, { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "height": 0 } ] }, "properties": { "displays": { "items": { "$ref": "#/components/schemas/DisplayInfo" }, "type": "array" } }, "type": "object" }, "Empty": { "type": "object" }, "ErrorResponse": { "description": "Error response", "example": { "path": "/api/resource", "code": "GIT_REPO_NOT_FOUND", "method": "GET", "source": "DAYTONA_DAEMON", "message": "Bad request", "statusCode": 400, "timestamp": "2023-01-01T12:00:00.000Z" }, "properties": { "code": { "allOf": [ { "$ref": "#/components/schemas/DaemonErrorCode" } ], "example": "GIT_REPO_NOT_FOUND", "type": "object" }, "message": { "example": "Bad request", "type": "string" }, "method": { "example": "GET", "type": "string" }, "path": { "example": "/api/resource", "type": "string" }, "source": { "example": "DAYTONA_DAEMON", "type": "string" }, "statusCode": { "example": 400, "type": "integer" }, "timestamp": { "example": "2023-01-01T12:00:00.000Z", "type": "string" } }, "required": [ "message", "path", "statusCode", "timestamp" ], "type": "object" }, "ExecuteRequest": { "example": { "cwd": "cwd", "envs": { "key": "envs" }, "command": "command", "timeout": 0 }, "properties": { "command": { "type": "string" }, "cwd": { "description": "Current working directory", "type": "string" }, "envs": { "additionalProperties": { "type": "string" }, "description": "Environment variables to set for the command", "type": "object" }, "timeout": { "description": "Timeout in seconds, defaults to 10 seconds", "type": "integer" } }, "required": [ "command" ], "type": "object" }, "ExecuteResponse": { "example": { "result": "result", "exitCode": 0 }, "properties": { "exitCode": { "type": "integer" }, "result": { "type": "string" } }, "required": [ "result" ], "type": "object" }, "FileInfo": { "example": { "mode": "mode", "owner": "owner", "path": "path", "size": 0, "modTime": "modTime", "modifiedAt": "modifiedAt", "permissions": "permissions", "name": "name", "group": "group", "isDir": true }, "properties": { "group": { "type": "string" }, "isDir": { "type": "boolean" }, "modTime": { "description": "Deprecated: ModTime uses Go's time.String() layout which is not a standard format.\nUse ModifiedAt instead, which is serialized as ISO 8601 / RFC 3339.", "type": "string" }, "mode": { "type": "string" }, "modifiedAt": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "string" }, "path": { "description": "Full path of the entry", "type": "string" }, "permissions": { "type": "string" }, "size": { "type": "integer" } }, "required": [ "group", "isDir", "modTime", "mode", "modifiedAt", "name", "owner", "permissions", "size" ], "type": "object" }, "FileStatus": { "example": { "extra": "extra", "name": "name", "staging": "Unmodified", "worktree": null }, "properties": { "extra": { "type": "string" }, "name": { "type": "string" }, "staging": { "$ref": "#/components/schemas/Status" }, "worktree": { "$ref": "#/components/schemas/Status" } }, "required": [ "extra", "name", "staging", "worktree" ], "type": "object" }, "FilesDownloadRequest": { "example": { "paths": [ "paths", "paths" ] }, "properties": { "paths": { "items": { "type": "string" }, "type": "array" } }, "required": [ "paths" ], "type": "object" }, "FindAccessibilityNodesRequest": { "example": { "role": "role", "scope": "scope", "limit": 0, "name": "name", "pid": 6, "nameMatch": "nameMatch", "states": [ "states", "states" ] }, "properties": { "limit": { "type": "integer" }, "name": { "type": "string" }, "nameMatch": { "description": "\"exact\" | \"substring\" | \"regex\"", "type": "string" }, "pid": { "type": "integer" }, "role": { "type": "string" }, "scope": { "type": "string" }, "states": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "GitAddRemoteRequest": { "example": { "path": "path", "fetch": true, "name": "name", "overwrite": true, "url": "url" }, "properties": { "fetch": { "description": "Fetch fetches from the remote immediately after adding it.", "type": "boolean" }, "name": { "type": "string" }, "overwrite": { "description": "Overwrite replaces an existing remote with the same name.", "type": "boolean" }, "path": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "path", "url" ], "type": "object" }, "GitAddRequest": { "example": { "path": "path", "files": [ "files", "files" ] }, "properties": { "files": { "description": "files to add (use . for all files)", "items": { "type": "string" }, "type": "array" }, "path": { "type": "string" } }, "required": [ "files", "path" ], "type": "object" }, "GitAuthenticateRequest": { "example": { "password": "password", "protocol": "protocol", "host": "host", "username": "username" }, "properties": { "host": { "description": "Host defaults to github.com.", "type": "string" }, "password": { "type": "string" }, "protocol": { "description": "Protocol defaults to https.", "type": "string" }, "username": { "type": "string" } }, "required": [ "password", "username" ], "type": "object" }, "GitBranchRequest": { "example": { "path": "path", "name": "name" }, "properties": { "name": { "type": "string" }, "path": { "type": "string" } }, "required": [ "name", "path" ], "type": "object" }, "GitCheckoutRequest": { "example": { "path": "path", "branch": "branch" }, "properties": { "branch": { "type": "string" }, "path": { "type": "string" } }, "required": [ "branch", "path" ], "type": "object" }, "GitCloneRequest": { "example": { "path": "path", "password": "password", "depth": 0, "branch": "branch", "commit_id": "commit_id", "insecure_skip_tls": true, "url": "url", "username": "username" }, "properties": { "branch": { "type": "string" }, "commit_id": { "type": "string" }, "depth": { "description": "Depth creates a shallow clone truncated to the given number of commits.", "type": "integer" }, "insecure_skip_tls": { "description": "Skip TLS certificate verification for this clone. Defaults to false (verify).\nSet to true ONLY for trusted internal Git servers with self-signed or\nprivate-CA certs; credentials, if supplied, will be transmitted over an\nunverified TLS connection and are exposed to any MITM on the route.", "type": "boolean" }, "password": { "type": "string" }, "path": { "type": "string" }, "url": { "type": "string" }, "username": { "type": "string" } }, "required": [ "path", "url" ], "type": "object" }, "GitCommitInfo": { "example": { "author": "author", "message": "message", "email": "email", "hash": "hash", "timestamp": "timestamp" }, "properties": { "author": { "type": "string" }, "email": { "type": "string" }, "hash": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "author", "email", "hash", "message", "timestamp" ], "type": "object" }, "GitCommitRequest": { "example": { "path": "path", "author": "author", "message": "message", "allow_empty": true, "email": "email" }, "properties": { "allow_empty": { "type": "boolean" }, "author": { "type": "string" }, "email": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" } }, "required": [ "author", "email", "message", "path" ], "type": "object" }, "GitCommitResponse": { "example": { "hash": "hash" }, "properties": { "hash": { "type": "string" } }, "required": [ "hash" ], "type": "object" }, "GitConfigResponse": { "example": { "value": "value" }, "properties": { "value": { "description": "Value is the config value, null when the key is not set.", "type": "string" } }, "type": "object" }, "GitConfigureUserRequest": { "example": { "path": "path", "scope": "scope", "name": "name", "email": "email" }, "properties": { "email": { "type": "string" }, "name": { "type": "string" }, "path": { "description": "Path is the repository path, required when scope is \"local\".", "type": "string" }, "scope": { "description": "Scope is one of global (default), local or system.", "type": "string" } }, "required": [ "email", "name" ], "type": "object" }, "GitDeleteBranchRequest": { "example": { "path": "path", "name": "name" }, "properties": { "name": { "type": "string" }, "path": { "type": "string" } }, "required": [ "name", "path" ], "type": "object" }, "GitInitRequest": { "example": { "initial_branch": "initial_branch", "path": "path", "bare": true }, "properties": { "bare": { "description": "Bare creates a repository without a working tree.", "type": "boolean" }, "initial_branch": { "description": "InitialBranch sets the name of the initial branch.", "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "GitPullRequest": { "example": { "path": "path", "password": "password", "remote": "remote", "branch": "branch", "username": "username" }, "properties": { "branch": { "description": "Branch to pull (defaults to the current branch's upstream).", "type": "string" }, "password": { "type": "string" }, "path": { "type": "string" }, "remote": { "description": "Remote to pull from (defaults to \"origin\").", "type": "string" }, "username": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "GitPushRequest": { "example": { "path": "path", "password": "password", "set_upstream": true, "remote": "remote", "branch": "branch", "username": "username" }, "properties": { "branch": { "description": "Branch to push (defaults to the current branch).", "type": "string" }, "password": { "type": "string" }, "path": { "type": "string" }, "remote": { "description": "Remote to push to (defaults to \"origin\").", "type": "string" }, "set_upstream": { "description": "SetUpstream records the pushed branch as the upstream tracking branch.", "type": "boolean" }, "username": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "GitRemote": { "example": { "name": "name", "url": "url" }, "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "url" ], "type": "object" }, "GitResetRequest": { "example": { "mode": "mode", "path": "path", "files": [ "files", "files" ], "target": "target" }, "properties": { "files": { "description": "Files constrains the reset to the given paths.", "items": { "type": "string" }, "type": "array" }, "mode": { "description": "Mode is one of soft, mixed (default), hard, merge or keep.", "type": "string" }, "path": { "type": "string" }, "target": { "description": "Target is the revision to reset to (defaults to HEAD).", "type": "string" } }, "required": [ "path" ], "type": "object" }, "GitRestoreRequest": { "example": { "path": "path", "files": [ "files", "files" ], "source": "source", "staged": true, "worktree": true }, "properties": { "files": { "items": { "type": "string" }, "type": "array" }, "path": { "type": "string" }, "source": { "description": "Source restores file contents from the given revision instead of the index.", "type": "string" }, "staged": { "description": "Staged restores the staging index for the given files.", "type": "boolean" }, "worktree": { "description": "Worktree restores the working tree for the given files.", "type": "boolean" } }, "required": [ "files", "path" ], "type": "object" }, "GitSetConfigRequest": { "example": { "path": "path", "scope": "scope", "value": "value", "key": "key" }, "properties": { "key": { "type": "string" }, "path": { "description": "Path is the repository path, required when scope is \"local\".", "type": "string" }, "scope": { "description": "Scope is one of global (default), local or system.", "type": "string" }, "value": { "type": "string" } }, "required": [ "key", "value" ], "type": "object" }, "GitStatus": { "example": { "detached": true, "behind": 6, "upstream": "upstream", "fileStatus": [ { "extra": "extra", "name": "name", "staging": "Unmodified", "worktree": null }, { "extra": "extra", "name": "name", "staging": "Unmodified", "worktree": null } ], "ahead": 0, "branchPublished": true, "currentBranch": "currentBranch" }, "properties": { "ahead": { "type": "integer" }, "behind": { "type": "integer" }, "branchPublished": { "type": "boolean" }, "currentBranch": { "type": "string" }, "detached": { "description": "Detached is true when HEAD is not on a branch (detached HEAD state).", "type": "boolean" }, "fileStatus": { "items": { "$ref": "#/components/schemas/FileStatus" }, "type": "array" }, "upstream": { "description": "Upstream is the upstream tracking branch (e.g. \"origin/main\"), empty when unset.", "type": "string" } }, "required": [ "currentBranch", "fileStatus" ], "type": "object" }, "InitializeRequest": { "example": { "token": "token" }, "properties": { "token": { "type": "string" } }, "type": "object" }, "InterpreterContext": { "example": { "createdAt": "createdAt", "cwd": "cwd", "active": true, "language": "language", "id": "id" }, "properties": { "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "cwd": { "type": "string" }, "id": { "type": "string" }, "language": { "type": "string" } }, "required": [ "active", "createdAt", "cwd", "id", "language" ], "type": "object" }, "IsPortInUseResponse": { "example": { "isInUse": true }, "properties": { "isInUse": { "type": "boolean" } }, "type": "object" }, "KeyboardHotkeyRequest": { "example": { "keys": "keys" }, "properties": { "keys": { "description": "e.g., \"ctrl+c\", \"cmd+v\"", "type": "string" } }, "type": "object" }, "KeyboardKeyDownRequest": { "example": { "key": "key" }, "properties": { "key": { "description": "e.g., \"ctrl\", \"shift\", \"a\"", "type": "string" } }, "required": [ "key" ], "type": "object" }, "KeyboardKeyUpRequest": { "example": { "key": "key" }, "properties": { "key": { "description": "e.g., \"ctrl\", \"shift\", \"a\"", "type": "string" } }, "required": [ "key" ], "type": "object" }, "KeyboardPressRequest": { "example": { "modifiers": [ "modifiers", "modifiers" ], "key": "key" }, "properties": { "key": { "type": "string" }, "modifiers": { "description": "ctrl, alt, shift, cmd", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "KeyboardTypeRequest": { "example": { "delay": 0, "text": "text" }, "properties": { "delay": { "description": "milliseconds between keystrokes", "type": "integer" }, "text": { "type": "string" } }, "type": "object" }, "ListBranchResponse": { "example": { "current": "current", "branches": [ "branches", "branches" ] }, "properties": { "branches": { "items": { "type": "string" }, "type": "array" }, "current": { "description": "Current is the name of the checked out branch (empty when HEAD is detached).", "type": "string" } }, "required": [ "branches" ], "type": "object" }, "ListContextsResponse": { "example": { "contexts": [ { "createdAt": "createdAt", "cwd": "cwd", "active": true, "language": "language", "id": "id" }, { "createdAt": "createdAt", "cwd": "cwd", "active": true, "language": "language", "id": "id" } ] }, "properties": { "contexts": { "items": { "$ref": "#/components/schemas/InterpreterContext" }, "type": "array" } }, "required": [ "contexts" ], "type": "object" }, "ListRecordingsResponse": { "example": { "recordings": [ { "fileName": "fileName", "durationSeconds": 0.8008281904610115, "filePath": "filePath", "startTime": "startTime", "endTime": "endTime", "id": "id", "sizeBytes": 6, "status": "status" }, { "fileName": "fileName", "durationSeconds": 0.8008281904610115, "filePath": "filePath", "startTime": "startTime", "endTime": "endTime", "id": "id", "sizeBytes": 6, "status": "status" } ] }, "properties": { "recordings": { "items": { "$ref": "#/components/schemas/Recording" }, "type": "array" } }, "required": [ "recordings" ], "type": "object" }, "ListRemotesResponse": { "example": { "remotes": [ { "name": "name", "url": "url" }, { "name": "name", "url": "url" } ] }, "properties": { "remotes": { "items": { "$ref": "#/components/schemas/GitRemote" }, "type": "array" } }, "required": [ "remotes" ], "type": "object" }, "LspCompletionParams": { "example": { "pathToProject": "pathToProject", "context": { "triggerCharacter": "triggerCharacter", "triggerKind": 0 }, "languageId": "languageId", "position": { "character": 6, "line": 1 }, "uri": "uri" }, "properties": { "context": { "$ref": "#/components/schemas/CompletionContext" }, "languageId": { "type": "string" }, "pathToProject": { "type": "string" }, "position": { "$ref": "#/components/schemas/LspPosition" }, "uri": { "type": "string" } }, "required": [ "languageId", "pathToProject", "position", "uri" ], "type": "object" }, "LspDocumentRequest": { "example": { "pathToProject": "pathToProject", "languageId": "languageId", "uri": "uri" }, "properties": { "languageId": { "type": "string" }, "pathToProject": { "type": "string" }, "uri": { "type": "string" } }, "required": [ "languageId", "pathToProject", "uri" ], "type": "object" }, "LspLocation": { "example": { "range": { "start": { "character": 6, "line": 1 }, "end": { "character": 6, "line": 1 } }, "uri": "uri" }, "properties": { "range": { "$ref": "#/components/schemas/LspRange" }, "uri": { "type": "string" } }, "required": [ "range", "uri" ], "type": "object" }, "LspPosition": { "example": { "character": 6, "line": 1 }, "properties": { "character": { "type": "integer" }, "line": { "type": "integer" } }, "required": [ "character", "line" ], "type": "object" }, "LspRange": { "example": { "start": { "character": 6, "line": 1 }, "end": { "character": 6, "line": 1 } }, "properties": { "end": { "$ref": "#/components/schemas/LspPosition" }, "start": { "$ref": "#/components/schemas/LspPosition" } }, "required": [ "end", "start" ], "type": "object" }, "LspServerRequest": { "example": { "pathToProject": "pathToProject", "languageId": "languageId" }, "properties": { "languageId": { "type": "string" }, "pathToProject": { "type": "string" } }, "required": [ "languageId", "pathToProject" ], "type": "object" }, "LspSymbol": { "example": { "kind": 0, "name": "name", "location": { "range": { "start": { "character": 6, "line": 1 }, "end": { "character": 6, "line": 1 } }, "uri": "uri" } }, "properties": { "kind": { "type": "integer" }, "location": { "$ref": "#/components/schemas/LspLocation" }, "name": { "type": "string" } }, "required": [ "kind", "location", "name" ], "type": "object" }, "Match": { "example": { "file": "file", "line": 0, "content": "content" }, "properties": { "content": { "type": "string" }, "file": { "type": "string" }, "line": { "type": "integer" } }, "required": [ "content", "file", "line" ], "type": "object" }, "MouseClickRequest": { "example": { "button": "button", "double": true, "x": 6, "clicks": 0, "y": 1, "modifiers": [ "modifiers", "modifiers" ] }, "properties": { "button": { "description": "left, right, middle", "type": "string" }, "clicks": { "description": "Clicks is a pointer so an omitted value is distinguishable from an\nexplicit 0, which must be rejected rather than silently defaulted.", "type": "integer" }, "double": { "type": "boolean" }, "modifiers": { "items": { "type": "string" }, "type": "array" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseClickResponse": { "example": { "x": 0, "y": 6 }, "properties": { "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseDownRequest": { "example": { "button": "button", "x": 0, "y": 6 }, "properties": { "button": { "description": "left, right, middle", "type": "string" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseDragRequest": { "example": { "button": "button", "endY": 6, "endX": 0, "startY": 5, "startX": 1, "modifiers": [ "modifiers", "modifiers" ] }, "properties": { "button": { "type": "string" }, "endX": { "type": "integer" }, "endY": { "type": "integer" }, "modifiers": { "items": { "type": "string" }, "type": "array" }, "startX": { "type": "integer" }, "startY": { "type": "integer" } }, "type": "object" }, "MouseDragResponse": { "example": { "x": 0, "y": 6 }, "properties": { "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseMoveRequest": { "example": { "x": 0, "y": 6 }, "properties": { "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MousePositionResponse": { "example": { "x": 0, "y": 6 }, "properties": { "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseScrollRequest": { "example": { "amount": 0, "x": 6, "y": 1, "modifiers": [ "modifiers", "modifiers" ], "direction": "direction" }, "properties": { "amount": { "minimum": 0, "type": "integer" }, "direction": { "description": "up, down, left, right", "type": "string" }, "modifiers": { "items": { "type": "string" }, "type": "array" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "MouseUpRequest": { "example": { "button": "button", "x": 0, "y": 6 }, "properties": { "button": { "description": "left, right, middle", "type": "string" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "PortList": { "example": { "ports": [ 0, 0 ] }, "properties": { "ports": { "items": { "type": "integer" }, "type": "array" } }, "type": "object" }, "Position": { "example": { "x": 0, "y": 6 }, "properties": { "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "ProcessErrorsResponse": { "example": { "processName": "processName", "errors": "errors" }, "properties": { "errors": { "type": "string" }, "processName": { "type": "string" } }, "type": "object" }, "ProcessLogsResponse": { "example": { "processName": "processName", "logs": "logs" }, "properties": { "logs": { "type": "string" }, "processName": { "type": "string" } }, "type": "object" }, "ProcessRestartResponse": { "example": { "processName": "processName", "message": "message" }, "properties": { "message": { "type": "string" }, "processName": { "type": "string" } }, "type": "object" }, "ProcessStatus": { "example": { "autoRestart": true, "running": true, "pid": 0, "priority": 6 }, "properties": { "autoRestart": { "type": "boolean" }, "pid": { "type": "integer" }, "priority": { "type": "integer" }, "running": { "type": "boolean" } }, "type": "object" }, "ProcessStatusResponse": { "example": { "running": true, "processName": "processName" }, "properties": { "processName": { "type": "string" }, "running": { "type": "boolean" } }, "type": "object" }, "PtyCreateRequest": { "example": { "cwd": "cwd", "lazyStart": true, "envs": { "key": "envs" }, "id": "id", "rows": 6, "cols": 0 }, "properties": { "cols": { "type": "integer" }, "cwd": { "type": "string" }, "envs": { "additionalProperties": { "type": "string" }, "type": "object" }, "id": { "type": "string" }, "lazyStart": { "description": "Don't start PTY until first client connects", "type": "boolean" }, "rows": { "type": "integer" } }, "type": "object" }, "PtyCreateResponse": { "example": { "sessionId": "sessionId" }, "properties": { "sessionId": { "type": "string" } }, "required": [ "sessionId" ], "type": "object" }, "PtyListResponse": { "example": { "sessions": [ { "createdAt": "createdAt", "cwd": "cwd", "lazyStart": true, "active": true, "envs": { "key": "envs" }, "id": "id", "rows": 6, "cols": 0 }, { "createdAt": "createdAt", "cwd": "cwd", "lazyStart": true, "active": true, "envs": { "key": "envs" }, "id": "id", "rows": 6, "cols": 0 } ] }, "properties": { "sessions": { "items": { "$ref": "#/components/schemas/PtySessionInfo" }, "type": "array" } }, "required": [ "sessions" ], "type": "object" }, "PtyResizeRequest": { "example": { "rows": 603, "cols": 81 }, "properties": { "cols": { "maximum": 1000, "minimum": 1, "type": "integer" }, "rows": { "maximum": 1000, "minimum": 1, "type": "integer" } }, "required": [ "cols", "rows" ], "type": "object" }, "PtySessionInfo": { "example": { "createdAt": "createdAt", "cwd": "cwd", "lazyStart": true, "active": true, "envs": { "key": "envs" }, "id": "id", "rows": 6, "cols": 0 }, "properties": { "active": { "type": "boolean" }, "cols": { "type": "integer" }, "createdAt": { "type": "string" }, "cwd": { "type": "string" }, "envs": { "additionalProperties": { "type": "string" }, "type": "object" }, "id": { "type": "string" }, "lazyStart": { "description": "Whether this session uses lazy start", "type": "boolean" }, "rows": { "type": "integer" } }, "required": [ "active", "cols", "createdAt", "cwd", "envs", "id", "lazyStart", "rows" ], "type": "object" }, "Recording": { "example": { "fileName": "fileName", "durationSeconds": 0.8008281904610115, "filePath": "filePath", "startTime": "startTime", "endTime": "endTime", "id": "id", "sizeBytes": 6, "status": "status" }, "properties": { "durationSeconds": { "type": "number" }, "endTime": { "type": "string" }, "fileName": { "type": "string" }, "filePath": { "type": "string" }, "id": { "type": "string" }, "sizeBytes": { "type": "integer" }, "startTime": { "type": "string" }, "status": { "type": "string" } }, "required": [ "fileName", "filePath", "id", "startTime", "status" ], "type": "object" }, "ReplaceRequest": { "example": { "newValue": "newValue", "pattern": "pattern", "files": [ "files", "files" ] }, "properties": { "files": { "items": { "type": "string" }, "type": "array" }, "newValue": { "type": "string" }, "pattern": { "type": "string" } }, "required": [ "files", "newValue", "pattern" ], "type": "object" }, "ReplaceResult": { "example": { "file": "file", "success": true, "error": "error" }, "properties": { "error": { "type": "string" }, "file": { "type": "string" }, "success": { "type": "boolean" } }, "type": "object" }, "ScreenshotResponse": { "example": { "cursorPosition": { "x": 0, "y": 6 }, "screenshot": "screenshot", "sizeBytes": 1 }, "properties": { "cursorPosition": { "$ref": "#/components/schemas/Position" }, "screenshot": { "type": "string" }, "sizeBytes": { "type": "integer" } }, "type": "object" }, "ScrollResponse": { "example": { "success": true }, "properties": { "success": { "type": "boolean" } }, "type": "object" }, "SearchFilesResponse": { "example": { "files": [ "files", "files" ] }, "properties": { "files": { "items": { "type": "string" }, "type": "array" } }, "required": [ "files" ], "type": "object" }, "Session": { "example": { "sessionId": "sessionId", "commands": [ { "exitCode": 0, "id": "id", "command": "command" }, { "exitCode": 0, "id": "id", "command": "command" } ] }, "properties": { "commands": { "items": { "$ref": "#/components/schemas/Command" }, "type": "array" }, "sessionId": { "type": "string" } }, "required": [ "commands", "sessionId" ], "type": "object" }, "SessionCommandLogsResponse": { "example": { "output": "output", "stdout": "stdout", "stderr": "stderr" }, "properties": { "output": { "type": "string" }, "stderr": { "type": "string" }, "stdout": { "type": "string" } }, "required": [ "output", "stderr", "stdout" ], "type": "object" }, "SessionExecuteRequest": { "example": { "async": true, "suppressInputEcho": true, "command": "command", "runAsync": true }, "properties": { "async": { "type": "boolean" }, "command": { "type": "string" }, "runAsync": { "type": "boolean" }, "suppressInputEcho": { "type": "boolean" } }, "required": [ "command" ], "type": "object" }, "SessionExecuteResponse": { "example": { "output": "output", "cmdId": "cmdId", "stdout": "stdout", "exitCode": 0, "stderr": "stderr" }, "properties": { "cmdId": { "type": "string" }, "exitCode": { "type": "integer" }, "output": { "type": "string" }, "stderr": { "type": "string" }, "stdout": { "type": "string" } }, "required": [ "cmdId" ], "type": "object" }, "SessionSendInputRequest": { "example": { "data": "data" }, "properties": { "data": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "StartRecordingRequest": { "example": { "label": "label" }, "properties": { "label": { "type": "string" } }, "type": "object" }, "Status": { "enum": [ "Unmodified", "Untracked", "Modified", "Added", "Deleted", "Renamed", "Copied", "Updated but unmerged" ], "type": "string", "x-enum-varnames": [ "Unmodified", "Untracked", "Modified", "Added", "Deleted", "Renamed", "Copied", "UpdatedButUnmerged" ] }, "StopRecordingRequest": { "example": { "id": "id" }, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "SystemMetrics": { "example": { "cpuUsedPct": 6.027456183070403, "timestampUnix": 3, "memTotal": 7, "diskUsed": 5, "diskTotal": 5, "memUsed": 9, "cpuCount": 0, "memCache": 2, "diskFree": 1, "timestamp": "timestamp" }, "properties": { "cpuCount": { "type": "integer" }, "cpuUsedPct": { "format": "double", "type": "number" }, "diskFree": { "format": "int64", "type": "integer" }, "diskTotal": { "format": "int64", "type": "integer" }, "diskUsed": { "format": "int64", "type": "integer" }, "memCache": { "format": "int64", "type": "integer" }, "memTotal": { "format": "int64", "type": "integer" }, "memUsed": { "format": "int64", "type": "integer" }, "timestamp": { "type": "string" }, "timestampUnix": { "format": "int64", "type": "integer" } }, "type": "object" }, "UpdateEnvRequest": { "example": { "set": { "key": "set" }, "unsetValuePrefix": "unsetValuePrefix", "unset": [ "unset", "unset" ] }, "properties": { "set": { "additionalProperties": { "type": "string" }, "description": "Set maps env var names to values applied to the daemon's process env, so\nprocesses spawned after the call (exec, sessions, PTYs) inherit them.", "type": "object" }, "unset": { "description": "Unset lists env var names to remove before Set is applied.", "items": { "type": "string" }, "type": "array" }, "unsetValuePrefix": { "description": "UnsetValuePrefix removes every env var whose value has this prefix and\nwhose name is not a key of Set, before Set is applied. Used to reconcile\nsecret placeholder vars without the caller knowing the daemon's env.", "type": "string" } }, "type": "object" }, "UploadFilesResponse": { "example": { "files": [ { "path": "path", "bytes": 0 }, { "path": "path", "bytes": 0 } ], "errors": [ "errors", "errors" ] }, "properties": { "errors": { "items": { "type": "string" }, "type": "array" }, "files": { "items": { "$ref": "#/components/schemas/fs.fileResult" }, "type": "array" } }, "type": "object" }, "UploadedFile": { "example": { "path": "path", "name": "name", "type": "type" }, "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "path", "type" ], "type": "object" }, "UserHomeDirResponse": { "example": { "dir": "dir" }, "properties": { "dir": { "type": "string" } }, "required": [ "dir" ], "type": "object" }, "WindowInfo": { "example": { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "title": "title", "height": 0 }, "properties": { "height": { "type": "integer" }, "id": { "type": "integer" }, "isActive": { "type": "boolean" }, "title": { "type": "string" }, "width": { "type": "integer" }, "x": { "type": "integer" }, "y": { "type": "integer" } }, "type": "object" }, "WindowsResponse": { "example": { "windows": [ { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "title": "title", "height": 0 }, { "width": 1, "x": 5, "y": 5, "id": 6, "isActive": true, "title": "title", "height": 0 } ] }, "properties": { "windows": { "items": { "$ref": "#/components/schemas/WindowInfo" }, "type": "array" } }, "type": "object" }, "WorkDirResponse": { "example": { "dir": "dir" }, "properties": { "dir": { "type": "string" } }, "required": [ "dir" ], "type": "object" }, "computeruse.AccessibilityNode": { "example": { "role": "role", "children": [ null, null ], "bounds": { "width": 6, "x": 1, "y": 5, "height": 0 }, "name": "name", "description": "description", "id": "id", "actions": [ "actions", "actions" ], "states": [ "states", "states" ] }, "properties": { "actions": { "items": { "type": "string" }, "type": "array" }, "bounds": { "$ref": "#/components/schemas/AccessibilityBounds" }, "children": { "items": { "$ref": "#/components/schemas/computeruse.AccessibilityNode" }, "type": "array" }, "description": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "role": { "type": "string" }, "states": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "fs.fileResult": { "example": { "path": "path", "bytes": 0 }, "properties": { "bytes": { "type": "integer" }, "path": { "type": "string" } }, "type": "object" }, "gin.H": { "additionalProperties": { "type": "object" }, "type": "object" }, "UploadFile_request": { "properties": { "file": { "description": "File to upload (multipart/form-data)", "format": "binary", "type": "string" } }, "type": "object" } }, "securitySchemes": { "Bearer": { "description": "Type \"Bearer\" followed by a space and your API key.", "in": "header", "name": "Authorization", "type": "apiKey" } } }, "x-original-swagger-version": "2.0" }