Commands API

Execute commands programmatically.

Last updated: January 15, 2025

POST/v1/commands

Execute a natural language command

// Request
POST /v1/commands
{
  "command": "Check my ETH balance",
  "agent_id": "agent_123",  // optional
  "async": false            // wait for result
}

// Response
{
  "id": "cmd_abc123",
  "status": "completed",
  "result": {
    "balance": "2.5 ETH",
    "usd_value": "$6,250.00"
  },
  "execution_time_ms": 450
}

GET/v1/commands/:id

Get command status and result

GET/v1/commands

List recent commands