REST API
JavaScript SDK
MCP
CLI
Scanner Web Service
CLI
Contact Support
Help Center

Loby CLI

The Loby CLI lists every museum, then lists, creates, and updates tasks across museums. It also lists and syncs Loby's managed devices (the iPads and Macs in Loby's MDM).

Authenticate with a platform API key from Admin → Tokens (WRITE_TASKS; for devices READ_MANAGED_DEVICES, WRITE_MANAGED_DEVICES, or WRITE_OWN_MANAGED_DEVICES). A key only reaches the commands of its own permissions: a task key gets NO_ACCESS on managed-devices. Museum REST keys from Developer Settings do not work with this CLI.

Install

Copy
curl -fsSL https://releases.loby.io/cli/install.sh | sh

The installer prints the next command if this shell needs loby on PATH. Full steps: Installation.

Commands

Copy
loby version
loby auth login
loby museums list
loby tasks list [--filter JSON] [--search TEXT] [--sorting JSON] [--limit N] [--offset N] [--include-deleted]
loby tasks get <id>
loby tasks create --museum-id ID --title TITLE [--description SLATE_JSON] [--status STATUS] [--due MS]
loby tasks create --kind DEV --title TITLE [--description SLATE_JSON] [--status STATUS] [--due MS]
loby tasks update <id> [--title TITLE] [--description SLATE_JSON] [--status STATUS] [--due MS] [--museum-order N]
loby tasks delete <id>
loby managed-devices list [--filter JSON] [--search TEXT] [--sorting JSON] [--limit N] [--offset N]
loby managed-devices get <id>
loby managed-devices create --serial SERIAL --name NAME --kind IPAD|MAC --role TILL|DEV|SUPPORT|OTHER --status ENROLLED|REMOVED [--enrollment-id ID] [--model MODEL] [--os-version V] [--build-version V] [--enrolled-at MS] [--last-seen-at MS]
loby managed-devices update <id> [--name NAME] [--kind KIND] [--role ROLE] [--status STATUS] [--enrollment-id ID] [--model MODEL] [--os-version V] [--build-version V] [--enrolled-at MS] [--last-seen-at MS]

There is a soft-delete command (loby tasks delete). Lists hide deleted tasks unless --include-deleted. Cancel a task with --status CANCELLED. Dates are Unix milliseconds UTC. --description is Slate JSON (same as the web editor), not markdown. Devices are created with managed-devices create and changed with managed-devices update <id>; find one by serial with managed-devices list --filter '{"fieldName":"serial","operator":"EQUAL","value":"<serial>"}'. Details are in the skill file.

Museums

loby museums list returns every museum as id then name, tab-separated. Use that id for --museum-id on create and for museumId in task filters. Do not guess ids.

Copy
loby museums list
Copy
a1b2c3d4-...	Acme Museum
e5f6a7b8-...	Another Museum
Next ›
Installation