Computers Coming soon

The Dopl desktop app on your user's Mac

Models

Dopl desktop appPlanned

Dopl's own app on macOS

Not supported yetWindows · Linux

CapabilityDopl desktop app
presence.readComing soon
present.notifyComing soon

Keys, connecting a user's device, permissions, routing, errors and test mode work the same for every category: see Projects, environments and keys, Connect a device, Permissions and safety, Errors and Test mode. The examples assume a dopl client and a deviceId from the Quickstart.

What your agent receives

Online status

presence.readT0

Whether the computer is on and the app has checked in recently.

Limits
  • Online when the app checked in within the last 150 seconds.
Permission
Scope state.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id } = await dopl.devices.action(deviceId, "presence.read", {});
const action = await dopl.actions.get(action_id);
console.log(action.result);

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "device_id": "8b0c6f1e-3d2a-4c51-9a7e-2f4d6b1c9e30",
  "capability": "presence.read",
  "status": "done",
  "result": {
    "simulated": true
  },
  "error": null,
  "created_at": "2026-10-27T17:05:00Z",
  "updated_at": "2026-10-27T17:05:09Z"
}

Supported on

  • Dopl desktop appComing soonThe Dopl desktop app takes notices only while signed in to a Dopl account, so the API refuses delivery with capability_unsupported today

What your agent can send

Notify

present.notifyT1

A system notification on the computer.

Limits
  • Set by each device's descriptor. No model in this category is connected yet.
Permission
Scope present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "present.notify", {
  title: "Build finished",
  body: "main passed"
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "done"
}

Supported on

  • Dopl desktop appComing soonThe Dopl desktop app takes notices only while signed in to a Dopl account, so the API refuses delivery with capability_unsupported today