device-platform

Manage RoomOS and PhoneOS device configurations, workspace personalization, and xAPI device control via wxcli.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/achobgood/wxops --skill device-platform-achobgood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: device-platform
Source: https://github.com/achobgood/wxops/tree/main/.claude/skills/device-platform
Command: npx skills add https://github.com/achobgood/wxops --skill device-platform-achobgood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring and controlling Webex RoomOS and PhoneOS devices requires knowing exact firmware-specific key names, correct API surfaces, and proper command sequencing, which is error-prone when done by hand or from memory. ## Core Features & Use Cases - Device Configuration Management: Read and update RoomOS/PhoneOS configuration keys on Room, Board, Desk, and 9800-series devices using JSON Patch operations via wxcli device-configurations. - Workspace Personalization: Push a user's speed dials, favorites, and call history to a shared workspace device with async task polling until completion. - xAPI Command and Status Control: Execute device commands (dial, volume, standby, alerts) and query live status values (call state, network, room analytics) through wxcli xapi. - Namespace Discovery: Dump the device's full command, status, and configuration namespace to disk and grep it locally instead of guessing key names. - Use Case: An admin needs to reset the camera position on a Room Bar Pro. The skill dumps the device's command namespace, finds Camera.PositionReset with its required arguments, executes it via wxcli xapi create, and verifies the result. ## Quick Start Ask the assistant to set the ultrasound max volume to 70 on your RoomOS device using the device-platform skill.

Frequently Asked Questions about device-platform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a RoomOS device configuration key with wxcli?

Use `wxcli device-configurations update` with a `--json-body` containing a JSON Patch array whose path ends in `/sources/configured/value`. The `--op` and `--path` flags are broken, so always pass the full JSON body instead.

How do I find the correct xAPI command or status name for a device?

Dump the device's full namespace with `wxcli xapi list --status "*"` and `--command "*"` to files, then grep them locally. Never guess key names, since namespaces like `Camera.*` and `Cameras.*` are both real and distinct.

Does xAPI work on Cisco 9800-series phones or MPP phones?

No, xAPI is RoomOS-only and works on Room, Board, and Desk series devices. 9800-series phones run PhoneOS and use the Device Configurations API instead, while MPP phones use device-settings via the manage-devices skill.

Why does my xAPI command fail with a 401 or 403 error?

xAPI requires user-level scopes `spark:xapi_statuses` and `spark:xapi_commands`, which are separate from admin device scopes. Re-authenticate with `wxcli configure` and verify the token includes the xAPI scopes.

How do I know when workspace personalization has finished?

Workspace personalization is asynchronous, so poll with `wxcli workspace-personalization show WORKSPACE_ID` until the response returns `success: true`. Typical completion time is around 30 seconds.