---
title: "Operate an authorized Mac host/device control [write]"
method: POST
path: "/desktop/mounts/{mount}/tools/{tool}"
tags: ["Desktop"]
---

# Operate an authorized Mac host/device control \[write\]

`POST /desktop/mounts/{mount}/tools/{tool}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/desktop/mounts/{mount}/tools/{tool}`
- Auth: HTTP bearer

Calls an exact host/device operation, or download, downloads, download_status, cancel_download on an owned browser mount. Browser download arguments are {ref,file_path,replace_existing?}; ref is the current read_page AX ref of an actual download anchor, never a URL. Status/cancel use {download_id}, list uses {}. Download requires current workspace, site and output-folder authorization. Status completion includes output.file_path, size_bytes and sha256. Human downloads are not agent-owned and cannot be cancelled. Cancel returns saving while an admitted native commit awaits its receipt; read download_status for the final receipt. All POST operations, including downloads and download_status, require a personal write key; the GET tools directory requires read scope. Each operation's host, device administration, destination, path and OS permissions remain enforced. A required_action response identifies a permission that needs setup. Reuse the stable request_id when retrying to avoid duplicate writes. Raw IPC names are refused. A tool-level error remains content/isError rather than a claimed success. The whole relay request envelope is limited to 1 MiB, including JSON and base64 expansion.

## Path parameters

- `mount` string, required
- `tool` string, required

## Query parameters

- `workspace` string

## Request body

- object
  - `arguments` object, required
  - `request_id` string, required

## Response `200`

OK

- object
  - `content` object[], required
  - `isError` boolean

## Other responses

- `400`: Error — { error: { code, message } }
- `401`: Error — { error: { code, message } }
- `403`: Error — { error: { code, message } }
- `404`: Error — { error: { code, message } }
- `409`: Error — { error: { code, message } }
- `503`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/desktop/mounts/:mount/tools/:tool/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)