manage-devices

Provision, configure, and manage Webex Calling devices, DECT networks, and workspaces via wxcli commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Webex Calling hardware — phones, ATAs, DECT systems, and workspace devices — requires navigating dozens of API endpoints with strict dependency ordering, model-specific routing, and non-obvious CLI flag conventions. This Skill encodes the correct procedures so devices are provisioned, activated, configured, and decommissioned without trial-and-error against a live production environment. ## Core Features & Use Cases - Device Lifecycle Management: Create devices by MAC address, generate activation codes for zero-touch provisioning, update tags, and delete devices with proper validation of MAC addresses and supported models. - DECT Provisioning: Enforces the strict dependency chain of DECT network → base stations → handsets, including bulk handset creation and serviceability password management. - Workspace & Settings Configuration: Create Webex Calling workspaces, assign devices, configure call settings, line key templates, device layouts, hot desking, and fleet-wide dynamic settings by tag. - Use Case: An admin needs to deploy 50 Cisco 8845 phones across two office locations. The Skill validates MAC addresses, creates devices assigned to users, applies a standard line key template org-wide, and tracks the bulk apply job to completion. ## Quick Start Ask the assistant to provision a new Cisco phone by MAC address for a specific user at a given location, and it will verify prerequisites, present a deployment plan, and execute the wxcli commands after your confirmation.

Frequently Asked Questions about manage-devices

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

FAQPage Schema
How do I provision a Cisco phone in Webex Calling by MAC address?

Validate the MAC with wxcli device-settings validate-a-list using a JSON body, then run wxcli devices create with the MAC, target person or workspace ID, and a supported model. The location and assignee must exist before device creation.

How do I set up a DECT phone system in Webex Calling?

DECT provisioning follows a strict chain: create the DECT network first, then add base stations using their physical hardware MACs, then add handsets with line assignments. You cannot skip steps since each layer depends on the previous one.

What is the difference between device activation codes and MAC provisioning?

MAC provisioning registers a specific device by its hardware address, while activation codes let a phone self-register when a user enters the code on the phone screen. Activation codes require the device to exist first and need a model parameter for phones.

Does this skill work with Cisco 9800-series phones?

Partially. Line key templates, member management, and person-level settings work through this skill, but device-level settings endpoints return 404 on 9800-series phones. Those devices run PhoneOS and require the device-platform skill for configuration keys.

Why does my wxcli device command fail with flag errors?

The CLI is auto-generated and flag names often differ from documentation examples. Always run wxcli <group> <subcommand> --help before constructing commands; for example, validate-a-list has no --macs flag and requires --json-body instead.

When should I use device-platform instead of manage-devices?

Use device-platform for PhoneOS or RoomOS configuration keys, xAPI commands like dial and volume, and any settings on Room, Board, or Desk series devices. Use manage-devices for provisioning, activation, line assignment, DECT, and workspace operations.