---
title: "Execute a target-scoped command in a session's desktop browser"
method: POST
path: "/api/v1/browser/commands"
tags: ["browser"]
---

# Execute a target-scoped command in a session's desktop browser

`POST /api/v1/browser/commands`

## Headers

- `X-AO-Browser-Capability` string — Opaque browser capability injected into the owning AO worker.

## Request body

- BrowserCommandRequest
  - `action` string, required
  - `args` object
  - `sessionId` string, required

## Response `200`

OK

- BrowserCommandResponse
  - `action` string, required
  - `requestId` string, required
  - `result` unknown, required
  - `sessionId` string, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `501` — Not Implemented
- `503` — Service Unavailable

---

[API](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/agent-orchestrator-http-daemon/versions/0754881ee8f4/schema)