ws1cli

ws1cli

A command-line interface for Workspace ONE UEM (Omnissa).

Commands are generated directly from the official WS1 UEM OpenAPI spec, so the CLI stays in sync with the API surface.

Installation

go install github.com/ancalabrese/ws1cli/cmd/ws1@latest

Or build from source:

make build        # outputs bin/ws1
make install      # installs to $GOPATH/bin

Setup

1. Set your server:

ws1 config --server as1831.awmdm.com --version 2506

2. Authenticate with OAuth2 client credentials:

ws1 login --client-id <client-id> --secret <client-secret>

By default the auth region is na. Use --region to pick another (na, emea, apac, uat).

Tokens are refreshed automatically before expiry.

3. Verify config:

ws1 config

Configuration is stored at ~/.config/ws1/config.json.

Usage

ws1 <group> <subgroup> <operation> [flags]

Commands are organised by API group:

All commands output pretty-printed JSON.

Example

ws1 mam apps list
ws1 mdm get-devices-search --platform Android

Global flags

Development

Regenerate everything from spec:

make gen          # gen-client + gen-cli
make gen-client   # API client (ws1/client.gen.go) via oapi-codegen
make gen-cli      # Cobra commands (internal/cli/gen/) via cmd/gen_cli

Validate the spec:

make validate