Models
Dopl desktop appPlanned
Dopl's own app on macOS
Not supported yetWindows · Linux
| Capability | Dopl desktop app |
|---|---|
presence.read | Coming soon |
present.notify | Coming 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.readT0Whether 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_unsupportedtoday
What your agent can send
Notify
present.notifyT1A 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_unsupportedtoday