Get Robot App Lock Status

Return the current state of the robot's managed-app lock.

The daemon's single source of truth for which managed app (if any) currently holds the robot:

free: no managed app holds the slot.
local_app: a Python app launched via AppManager is running. holder_name is the app name.
remote_session: a remote WebRTC client is connected via the central signaling relay. holder_name is a generic "remote" placeholder (the real consumer app name lives on the central server and is surfaced via its own /api/robot-status).

Note that SDK clients talking to the daemon directly bypass this lock; it only reflects the two managed app entry points.

Intended for UI layers (desktop app, dashboard) that want to render a busy/free indicator without trying to open a session.

get/api/daemon/robot-app-lock-status

Response

Successful Response

state'free' | 'local_app' | 'remote_session' required

Lock state enum. Values are stable strings suitable for serialization.

holder_namestring nullable

Changed in 2 of the 26 revisions of this API.11

Apr 21, 2026a1a4205ef62a1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 3, 20268d430e48a90a1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog