Daytona Sandbox Toolbox API

swagger: '2.0'
info:
  description: Daytona Toolbox API
  title: Daytona Sandbox Toolbox API
  contact: {}
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: v0.0.0-dev
paths:
  /computeruse/a11y/find:
    post:
      description: Search the AT-SPI tree for nodes matching a role/name/state filter and return a flat list.
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Find accessibility nodes
      operationId: FindAccessibilityNodes
      parameters:
      - description: Find request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/FindAccessibilityNodesRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AccessibilityNodesResponse'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
        '503':
          description: Service Unavailable
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/a11y/node/focus:
    post:
      description: Move keyboard focus to the AT-SPI node identified by id (bus-name:object-path).
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Focus an accessibility node
      operationId: FocusAccessibilityNode
      parameters:
      - description: Node focus request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/AccessibilityNodeRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
        '503':
          description: Service Unavailable
          schema:
            type: object
            additionalProperties:
              type: string
  /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.
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Invoke an action on an accessibility node
      operationId: InvokeAccessibilityNode
      parameters:
      - description: Invoke request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/AccessibilityInvokeRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
        '503':
          description: Service Unavailable
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/a11y/node/value:
    post:
      description: Write the given value to the node via EditableText.SetTextContents or, for numeric controls, Value.CurrentValue.
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Set the value of an accessibility node
      operationId: SetAccessibilityNodeValue
      parameters:
      - description: Set value request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/AccessibilitySetValueRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
        '503':
          description: Service Unavailable
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/a11y/tree:
    get:
      description: Fetch the AT-SPI accessibility tree for the focused application, a specific PID, or all registered applications.
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get accessibility tree
      operationId: GetAccessibilityTree
      parameters:
      - type: string
        description: 'Scope: focused | pid | all (default: focused)'
        name: scope
        in: query
      - type: integer
        description: Process ID when scope=pid
        name: pid
        in: query
      - type: integer
        description: Max tree depth (-1 unbounded, 0 root only; default -1)
        name: maxDepth
        in: query
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AccessibilityTreeResponse'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
        '503':
          description: Service Unavailable
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/display/info:
    get:
      description: Get information about all available displays
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get display information
      operationId: GetDisplayInfo
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/DisplayInfoResponse'
  /computeruse/display/windows:
    get:
      description: Get information about all open windows
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get windows information
      operationId: GetWindows
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/WindowsResponse'
  /computeruse/keyboard/hotkey:
    post:
      description: Press a hotkey combination (e.g., ctrl+c, cmd+v)
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Press hotkey
      operationId: PressHotkey
      parameters:
      - description: Hotkey press request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/KeyboardHotkeyRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
  /computeruse/keyboard/key:
    post:
      description: Press a key with optional modifiers
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Press key
      operationId: PressKey
      parameters:
      - description: Key press request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/KeyboardPressRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
  /computeruse/keyboard/type:
    post:
      description: Type text with optional delay between keystrokes
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Type text
      operationId: TypeText
      parameters:
      - description: Text typing request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/KeyboardTypeRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Empty'
  /computeruse/mouse/click:
    post:
      description: Click the mouse button at the specified coordinates
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Click mouse button
      operationId: Click
      parameters:
      - description: Mouse click request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/MouseClickRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/MouseClickResponse'
  /computeruse/mouse/drag:
    post:
      description: Drag the mouse from start to end coordinates
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Drag mouse
      operationId: Drag
      parameters:
      - description: Mouse drag request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/MouseDragRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/MouseDragResponse'
  /computeruse/mouse/move:
    post:
      description: Move the mouse cursor to the specified coordinates
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Move mouse cursor
      operationId: MoveMouse
      parameters:
      - description: Mouse move request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/MouseMoveRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/MousePositionResponse'
  /computeruse/mouse/position:
    get:
      description: Get the current mouse cursor position
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get mouse position
      operationId: GetMousePosition
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/MousePositionResponse'
  /computeruse/mouse/scroll:
    post:
      description: Scroll the mouse wheel at the specified coordinates
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Scroll mouse wheel
      operationId: Scroll
      parameters:
      - description: Mouse scroll request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/MouseScrollRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ScrollResponse'
  /computeruse/process-status:
    get:
      description: Get the status of all computer use processes
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get computer use process status
      operationId: GetComputerUseStatus
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ComputerUseStatusResponse'
  /computeruse/process/{processName}/errors:
    get:
      description: Get errors for a specific computer use process
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get process errors
      operationId: GetProcessErrors
      parameters:
      - type: string
        description: Process name to get errors for
        name: processName
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ProcessErrorsResponse'
  /computeruse/process/{processName}/logs:
    get:
      description: Get logs for a specific computer use process
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get process logs
      operationId: GetProcessLogs
      parameters:
      - type: string
        description: Process name to get logs for
        name: processName
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ProcessLogsResponse'
  /computeruse/process/{processName}/restart:
    post:
      description: Restart a specific computer use process
      produces:
      - application/json
      tags:
      - computer-use
      summary: Restart specific process
      operationId: RestartProcess
      parameters:
      - type: string
        description: Process name to restart
        name: processName
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ProcessRestartResponse'
  /computeruse/process/{processName}/status:
    get:
      description: Check if a specific computer use process is running
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get specific process status
      operationId: GetProcessStatus
      parameters:
      - type: string
        description: Process name to check
        name: processName
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ProcessStatusResponse'
  /computeruse/recordings:
    get:
      description: Get a list of all recordings (active and completed)
      produces:
      - application/json
      tags:
      - computer-use
      summary: List all recordings
      operationId: ListRecordings
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ListRecordingsResponse'
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/recordings/start:
    post:
      description: Start a new screen recording session
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Start a new recording
      operationId: StartRecording
      parameters:
      - description: Recording options
        name: request
        in: body
        schema:
          $ref: '#/definitions/StartRecordingRequest'
      responses:
        '201':
          description: Created
          schema:
            $ref: '#/definitions/Recording'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/recordings/stop:
    post:
      description: Stop an active screen recording session
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - computer-use
      summary: Stop a recording
      operationId: StopRecording
      parameters:
      - description: Recording ID to stop
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/StopRecordingRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Recording'
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/recordings/{id}:
    get:
      description: Get details of a specific recording by ID
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get recording details
      operationId: GetRecording
      parameters:
      - type: string
        description: Recording ID
        name: id
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Recording'
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
    delete:
      description: Delete a recording file by ID
      tags:
      - computer-use
      summary: Delete a recording
      operationId: DeleteRecording
      parameters:
      - type: string
        description: Recording ID
        name: id
        in: path
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          schema:
            type: object
            additionalProperties:
              type: string
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/recordings/{id}/download:
    get:
      description: Download a recording by providing its ID
      produces:
      - application/octet-stream
      tags:
      - computer-use
      summary: Download a recording
      operationId: DownloadRecording
      parameters:
      - type: string
        description: Recording ID
        name: id
        in: path
        required: true
      responses:
        '200':
          description: OK
          schema:
            type: file
        '404':
          description: Not Found
          schema:
            type: object
            additionalProperties:
              type: string
        '500':
          description: Internal Server Error
          schema:
            type: object
            additionalProperties:
              type: string
  /computeruse/screenshot:
    get:
      description: Take a screenshot of the entire screen
      produces:
      - application/json
      tags:
      - computer-use
      summary: Take a screenshot
      operationId: TakeScreenshot
      parameters:
      - type: boolean
        description: Whether to show cursor in screenshot
        name: showCursor
        in: query
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ScreenshotResponse'
  /computeruse/screenshot/compressed:
    get:
      description: Take a compressed screenshot of the entire screen
      produces:
      - application/json
      tags:
      - computer-use
      summary: Take a compressed screenshot
      operationId: TakeCompressedScreenshot
      parameters:
      - type: boolean
        description: Whether to show cursor in screenshot
        name: showCursor
        in: query
      - type: string
        description: Image format (png or jpeg)
        name: format
        in: query
      - type: integer
        description: JPEG quality (1-100)
        name: quality
        in: query
      - type: number
        description: Scale factor (0.1-1.0)
        name: scale
        in: query
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ScreenshotResponse'
  /computeruse/screenshot/region:
    get:
      description: Take a screenshot of a specific region of the screen
      produces:
      - application/json
      tags:
      - computer-use
      summary: Take a region screenshot
      operationId: TakeRegionScreenshot
      parameters:
      - type: integer
        description: X coordinate of the region
        name: x
        in: query
        required: true
      - type: integer
        description: Y coordinate of the region
        name: y
        in: query
        required: true
      - type: integer
        description: Width of the region
        name: width
        in: query
        required: true
      - type: integer
        description: Height of the region
        name: height
        in: query
        required: true
      - type: boolean
        description: Whether to show cursor in screenshot
        name: showCursor
        in: query
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ScreenshotResponse'
  /computeruse/screenshot/region/compressed:
    get:
      description: Take a compressed screenshot of a specific region of the screen
      produces:
      - application/json
      tags:
      - computer-use
      summary: Take a compressed region screenshot
      operationId: TakeCompressedRegionScreenshot
      parameters:
      - type: integer
        description: X coordinate of the region
        name: x
        in: query
        required: true
      - type: integer
        description: Y coordinate of the region
        name: y
        in: query
        required: true
      - type: integer
        description: Width of the region
        name: width
        in: query
        required: true
      - type: integer
        description: Height of the region
        name: height
        in: query
        required: true
      - type: boolean
        description: Whether to show cursor in screenshot
        name: showCursor
        in: query
      - type: string
        description: Image format (png or jpeg)
        name: format
        in: query
      - type: integer
        description: JPEG quality (1-100)
        name: quality
        in: query
      - type: number
        description: Scale factor (0.1-1.0)
        name: scale
        in: query
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ScreenshotResponse'
  /computeruse/start:
    post:
      description: Start all computer use processes and return their status
      produces:
      - application/json
      tags:
      - computer-use
      summary: Start computer use processes
      operationId: StartComputerUse
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ComputerUseStartResponse'
  /computeruse/status:
    get:
      description: Get the current status of the computer use system
      produces:
      - application/json
      tags:
      - computer-use
      summary: Get computer use status
      operationId: GetComputerUseSystemStatus
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ComputerUseStatusResponse'
  /computeruse/stop:
    post:
      description: Stop all computer use processes and return their status
      produces:
      - application/json
      tags:
      - computer-use
      summary: Stop computer use processes
      operationId: StopComputerUse
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/ComputerUseStopResponse'
  /files:
    get:
      description: List files and directories in the specified path
      produces:
      - application/json
      tags:
      - file-system
      summary: List files and directories
      operationId: ListFiles
      parameters:
      - type: string
        description: Directory path to list (defaults to working directory)
        name: path
        in: query
      responses:
        '200':
          description: OK
          schema:
            type: array
            items:
              $ref: '#/definitions/FileInfo'
    delete:
      description: Delete a file or directory at the specified path
      tags:
      - file-system
      summary: Delete a file or directory
      operationId: DeleteFile
      parameters:
      - type: string
        description: File or directory path to delete
        name: path
        in: query
        required: true
      - type: boolean
        description: Enable recursive deletion for directories
        name: recursive
        in: query
      responses:
        '204':
          description: No Content
  /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.
      consumes:
      - application/json
      produces:
      - multipart/form-data
      tags:
      - file-system
      summary: Download multiple files
      operationId: DownloadFiles
      parameters:
      - description: Paths of files to download
        name: downloadFiles
        in: body
        required: true
        schema:
          $ref: '#/definitions/FilesDownloadRequest'
      responses:
        '200':
          description: Multipart response with file parts and JSON error parts
          schema:
            $ref: '#/definitions/gin.H'
  /files/bulk-upload:
    post:
      description: Upload multiple files with their destination paths
      consumes:
      - multipart/form-data
      tags:
      - file-system
      summary: Upload multiple files
      operationId: UploadFiles
      responses:
        '200':
          description: OK
  /files/download:
    get:
      description: Download a file by providing its path
      produces:
      - application/octet-stream
      tags:
      - file-system
      summary: Download a file
      operationId: DownloadFile
      parameters:
      - type: string
        description: File path to download
        name: path
        in: query
        required: true
      responses:
        '200':
          description: OK
          schema:
            type: file
  /files/find:
    get:
      description: Search for text pattern within files in a directory
      produces:
      - application/json
      tags:
      - file-system
      summary: Find text in files
      operationId: FindInFiles
      parameters:
      - type: string
        description: Directory path to search in
        name: path
        in: query
        required: true
      - type: string
        description: Text pattern to search for
        name: pattern
        in: query
        required: true
      responses:
        '200':
          description: OK
          schema:
            type: array
            items:
              $ref: '#/definitions/Match'
  /files/folder:
    post:
      description: Create a folder with the specified path and optional permissions
      consumes:
      - application/json
      tags:
      - file-system
      summary: Create a folder
      operationId: CreateFolder
      parameters:
      - type: string
        description: Folder path to create
        name: path
        in: query
        required: true
      - type: string
        description: 'Octal permission mode (default: 0755)'
        name: mode
        in: query
        required: true
      responses:
        '201':
          description: Created
  /files/info:
    get:
      description: Get detailed information about a file or directory
      produces:
      - application/json
      tags:
      - file-system
      summary: Get file information
      operationId: GetFileInfo
      parameters:
      - type: string
        description: File or directory path
        name: path
        in: query
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/FileInfo'
  /files/move:
    post:
      description: Move or rename a file or directory from source to destination
      tags:
      - file-system
      summary: Move or rename file/directory
      operationId: MoveFile
      parameters:
      - type: string
        description: Source file or directory path
        name: source
        in: query
        required: true
      - type: string
        description: Destination file or directory path
        name: destination
        in: query
        required: true
      responses:
        '200':
          description: OK
  /files/permissions:
    post:
      description: Set file permissions, ownership, and group for a file or directory
      tags:
      - file-system
      summary: Set file permissions
      operationId: SetFilePermissions
      parameters:
      - type: string
        description: File or directory path
        name: path
        in: query
        required: true
      - type: string
        description: Owner (username or UID)
        name: owner
        in: query
      - type: string
        description: Group (group name or GID)
        name: group
        in: query
      - type: string
        description: File mode in octal format (e.g., 0755)
        name: mode
        in: query
      responses:
        '200':
          description: OK
  /files/replace:
    post:
      description: Replace text pattern with new value in multiple files
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - file-system
      summary: Replace text in files
      operationId: ReplaceInFiles
      parameters:
      - description: Replace request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/ReplaceRequest'
      responses:
        '200':
          description: OK
          schema:
            type: array
            items:
              $ref: '#/definitions/ReplaceResult'
  /files/search:
    get:
      description: Search for files matching a specific pattern in a directory
      produces:
      - application/json
      tags:
      - file-system
      summary: Search files by pattern
      operationId: SearchFiles
      parameters:
      - type: string
        description: Directory path to search in
        name: path
        in: query
        required: true
      - type: string
        description: File pattern to match (e.g., *.txt, *.go)
        name: pattern
        in: query
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/SearchFilesResponse'
  /files/upload:
    post:
      description: Upload a file to the specified path
      consumes:
      - multipart/form-data
      tags:
      - file-system
      summary: Upload a file
      operationId: UploadFile
      parameters:
      - type: string
        description: Destination path for the uploaded file
        name: path
        in: query
        required: true
      - type: file
        description: File to upload
        name: file
        in: formData
        required: true
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/gin.H'
  /git/add:
    post:
      description: Add files to the Git staging area
      consumes:
      - application/json
      produces:
      - application/json
      tags:
      - git
      summary: Add files to Git staging
      operationId: AddFiles
      parameters:
      - description: Add files request
        name: request
        in: body
        required: true
        schema:
          $ref: '#/definitions/GitAddRequest'
      responses:
        '200':
          description: OK
  /git/branches:
    get:
     

# --- truncated at 32 KB (76 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/openapi/daytona-sandbox-toolbox-api-openapi.yml