---
title: "Report whether Cua Driver is installed, its version and update, its background service, and macOS permissions"
method: GET
path: "/api/v1/computer-use/status"
tags: ["computer-use"]
---

# Report whether Cua Driver is installed, its version and update, its background service, and macOS permissions

`GET /api/v1/computer-use/status`

## Request

- Base URL: `http://127.0.0.1:3001`
- URL: `http://127.0.0.1:3001/api/v1/computer-use/status`
- Auth: none declared

## Response `200`

OK

- ComputerUseStatus
  - `binaryPath` string: The cua-driver executable AO runs.
  - `daemon` 'running' | 'stopped' | 'unknown', required: Whether Cua Driver's background service answers.
  - `imageDirectory` string, required: Where screenshots from computer-use calls are saved.
  - `installed` boolean, required
  - `latestVersion` string: Newest release on the driver's update channel, when it could be checked.
  - `permissions` ComputerUsePermissions
    - `accessibility` 'granted' | 'missing' | 'unknown', required: Accessibility, needed to read and operate app controls.
    - `grantError` string: Why the last permission request failed.
    - `granting` boolean, required: A permission request is waiting on the user in System Settings.
    - `screenRecording` 'granted' | 'missing' | 'unknown', required: Screen Recording, needed for screenshots.
  - `platform` string, required: Operating system the daemon runs on: darwin, linux, or windows.
  - `releaseNotesUrl` string
  - `updateAvailable` boolean, required
  - `version` string

## Other responses

- `409`: Conflict
- `500`: Internal Server Error
- `501`: Not Implemented
- `503`: Service Unavailable

## Changes

- **2026-10-28** `3a5588b32f85`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/computer-use/status/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) - [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/3a5588b32f85?raw)