Skip to main content
POST
/
node
/
desktop
/
tool
curl --request POST \
  --url 'https://zeus-api.agentspro.cn/node/desktop/tool?user_id=user_123' \
  --header 'Content-Type: application/json' \
  --data '{
    "tool_name": "run_command",
    "tool_args": { "command": "ls -la" }
  }'

{
  "success": true,
  "result": {
    "stdout": "total 48\ndrwxr-xr-x  12 user  staff  384 Jun 15 10:00 .\n..."
  }
}
Sends a JSON-RPC tool call request to the desktop application over WebSocket and waits for the execution result. Timeout is 60 seconds.
​
user_id
string
required
User ID
​
tool_name
string
required
Tool name
​
tool_args
object
default:"{}"
Tool arguments
​
session_id
string
Session ID (optional, used to route to the bound node)
curl --request POST \
  --url 'https://zeus-api.agentspro.cn/node/desktop/tool?user_id=user_123' \
  --header 'Content-Type: application/json' \
  --data '{
    "tool_name": "run_command",
    "tool_args": { "command": "ls -la" }
  }'

{
  "success": true,
  "result": {
    "stdout": "total 48\ndrwxr-xr-x  12 user  staff  384 Jun 15 10:00 .\n..."
  }
}