wxcli 1.2.0__py3-none-any.whl

wxcli/commands/scim_bulk.py

@@ -0,0 +1,46 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+from wxcli.config import resolve_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling scim-bulk.")
+
+
+@app.command("create")
+def create(
+    fail_on_errors: str = typer.Option(None, "--fail-on-errors", help="(required) An integer specifying the maximum number of errors that the"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """User bulk API\n\nExample --json-body:\n  '{"schemas":["..."],"failOnErrors":0,"operations":[{"method":"...","path":"...","data":"...","bulkId":"..."}]}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Bulk"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if fail_on_errors is not None:
+            body["failOnErrors"] = fail_on_errors
+        _missing = [f for f in ['failOnErrors'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+

wxcli/commands/scim_groups.py

@@ -0,0 +1,246 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+from wxcli.config import resolve_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling scim-groups.")
+
+
+@app.command("list")
+def cmd_list(
+    filter_param: str = typer.Option(None, "--filter", help="The url encoded filter. The example content is 'displayName"),
+    attributes: str = typer.Option(None, "--attributes", help="The attributes to return."),
+    excluded_attributes: str = typer.Option(None, "--excluded-attributes", help="Attributes to be excluded from the return."),
+    sort_by: str = typer.Option(None, "--sort-by", help="A string indicating the attribute whose value be used to ord"),
+    sort_order: str = typer.Option(None, "--sort-order", help="A string indicating the order in which the `sortBy` paramete"),
+    start_index: str = typer.Option(None, "--start-index", help="An integer indicating the 1-based index of the first query r"),
+    count: str = typer.Option(None, "--count", help="An integer indicating the desired maximum number of query re"),
+    include_members: str = typer.Option(None, "--include-members", help="Default \"false\". If false, no members returned."),
+    member_type: str = typer.Option(None, "--member-type", help="Filter the members by member type. Sample data: `user`, `mac"),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Search groups."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups"
+    params = {}
+    if filter_param is not None:
+        params["filter"] = filter_param
+    if attributes is not None:
+        params["attributes"] = attributes
+    if excluded_attributes is not None:
+        params["excludedAttributes"] = excluded_attributes
+    if sort_by is not None:
+        params["sortBy"] = sort_by
+    if sort_order is not None:
+        params["sortOrder"] = sort_order
+    if start_index is not None:
+        params["startIndex"] = start_index
+    if count is not None:
+        params["count"] = count
+    if include_members is not None:
+        params["includeMembers"] = include_members
+    if member_type is not None:
+        params["memberType"] = member_type
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("Resources", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[("ID", "id"), ("Name", "name")], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    display_name: str = typer.Option(None, "--display-name", help="(required) A human-readable name for the Group."),
+    external_id: str = typer.Option(None, "--external-id", help="An identifier for the resource as defined by the provisionin"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Create a group\n\nExample --json-body:\n  '{"schemas":["..."],"displayName":"...","externalId":"...","members":[{"value":"...","type":"..."}],"urn:scim:schemas:extension:cisco:webexidentity:2.0:Group":{"usage":"...","owners":["..."],"inheritances":["..."],"managedBy":["..."]}}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if display_name is not None:
+            body["displayName"] = display_name
+        if external_id is not None:
+            body["externalId"] = external_id
+        _missing = [f for f in ['displayName'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+
+
+@app.command("show")
+def show(
+    group_id: str = typer.Argument(help="groupId"),
+    excluded_attributes: str = typer.Option(None, "--excluded-attributes", help="Attributes to be excluded from the return."),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get a group."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups/{group_id}"
+    params = {}
+    if excluded_attributes is not None:
+        params["excludedAttributes"] = excluded_attributes
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+
+
+@app.command("update")
+def update(
+    group_id: str = typer.Argument(help="groupId"),
+    display_name: str = typer.Option(None, "--display-name", help="A human-readable name for the group."),
+    external_id: str = typer.Option(None, "--external-id", help="An identifier for the resource as defined by the provisionin"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a group with PUT\n\nExample --json-body:\n  '{"schemas":["..."],"displayName":"...","externalId":"...","members":[{"value":"...","type":"..."}],"urn:scim:schemas:extension:cisco:webexidentity:2.0:Group":{"usage":"...","owners":["..."],"inheritances":["..."],"managedBy":["..."]}}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups/{group_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if display_name is not None:
+            body["displayName"] = display_name
+        if external_id is not None:
+            body["externalId"] = external_id
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("update-groups")
+def update_groups(
+    group_id: str = typer.Argument(help="groupId"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a group with PATCH\n\nExample --json-body:\n  '{"schemas":["..."],"Operations":[{"op":"...","path":"...","value":"..."}]}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups/{group_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    try:
+        result = api.session.rest_patch(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    group_id: str = typer.Argument(help="groupId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a group."""
+    if not force:
+        typer.confirm(f"Delete {group_id}?", abort=True)
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups/{group_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {group_id}")
+
+
+
+@app.command("list-members")
+def list_members(
+    group_id: str = typer.Argument(help="groupId"),
+    start_index: str = typer.Option(None, "--start-index", help="The index to start for group pagination."),
+    count: str = typer.Option(None, "--count", help="Non-negative integer that specifies the desired number of se"),
+    member_type: str = typer.Option(None, "--member-type", help="Filter the members by member type. Sample data: `user`, `mac"),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Group Members."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Groups/{group_id}/Members"
+    params = {}
+    if start_index is not None:
+        params["startIndex"] = start_index
+    if count is not None:
+        params["count"] = count
+    if member_type is not None:
+        params["memberType"] = member_type
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("members", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[("ID", "id"), ("Name", "name")], limit=limit)
+
+

wxcli/commands/scim_schemas.py

@@ -0,0 +1,82 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+
+
+app = typer.Typer(help="Manage Webex Calling scim-schemas.")
+
+
+@app.command("show")
+def show(
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Group Schema."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/Schemas/SCIM2/Group"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+
+
+@app.command("show-user")
+def show_user(
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get User Schema."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/Schemas/SCIM2/User"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+
+
+@app.command("show-scim2")
+def show_scim2(
+    schema_id: str = typer.Argument(help="schemaId"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Schema using Group Schema ID."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/Schemas/SCIM2/{schema_id}"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+

wxcli/commands/scim_users.py

@@ -0,0 +1,283 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+from wxcli.config import resolve_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling scim-users.")
+
+
+@app.command("list")
+def cmd_list(
+    filter_param: str = typer.Option(None, "--filter", help="The URL encoded filter. If the value is empty, the API will"),
+    attributes: str = typer.Option(None, "--attributes", help="A multi-valued list of string names for resource attributes"),
+    excluded_attributes: str = typer.Option(None, "--excluded-attributes", help="A multi-valued list of strings names for resource attributes"),
+    sort_by: str = typer.Option(None, "--sort-by", help="A string for the attribute whose value can be used to order"),
+    sort_order: str = typer.Option(None, "--sort-order", help="A string for the order in which the 'sortBy' parameter is ap"),
+    start_index: str = typer.Option(None, "--start-index", help="An integer for the 1-based index of the first query result."),
+    count: str = typer.Option(None, "--count", help="An integer for the maximum number of query results per page."),
+    return_groups: str = typer.Option(None, "--return-groups", help="Define whether the group information needs to be returned."),
+    include_group_details: str = typer.Option(None, "--include-group-details", help="Define whether the group information with details needs to b"),
+    group_usage_types: str = typer.Option(None, "--group-usage-types", help="Returns groups with details of the specified group type."),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Search users."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users"
+    params = {}
+    if filter_param is not None:
+        params["filter"] = filter_param
+    if attributes is not None:
+        params["attributes"] = attributes
+    if excluded_attributes is not None:
+        params["excludedAttributes"] = excluded_attributes
+    if sort_by is not None:
+        params["sortBy"] = sort_by
+    if sort_order is not None:
+        params["sortOrder"] = sort_order
+    if start_index is not None:
+        params["startIndex"] = start_index
+    if count is not None:
+        params["count"] = count
+    if return_groups is not None:
+        params["returnGroups"] = return_groups
+    if include_group_details is not None:
+        params["includeGroupDetails"] = include_group_details
+    if group_usage_types is not None:
+        params["groupUsageTypes"] = group_usage_types
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("Resources", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[('ID', 'id'), ('Display Name', 'displayName'), ('User Name', 'userName'), ('Active', 'active')], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    user_name: str = typer.Option(None, "--user-name", help="(required) A unique identifier for the user that authenticates the user"),
+    user_type: str = typer.Option(None, "--user-type", help="(required) Choices: user, room, external_calling, calling_service"),
+    title: str = typer.Option(None, "--title", help="The user's business title.  Examples of a title is \"Business"),
+    active: bool = typer.Option(None, "--active/--no-active", help="A boolean value of \"true\" or \"false\" indicating whether the"),
+    preferred_language: str = typer.Option(None, "--preferred-language", help="User's preferred language. Acceptable values are based on th"),
+    locale: str = typer.Option(None, "--locale", help="The user's locale which represents the user's currency, time"),
+    timezone: str = typer.Option(None, "--timezone", help="The user's time zone specified in the [IANA timezone](https:"),
+    profile_url: str = typer.Option(None, "--profile-url", help="A fully qualified URL pointing to a page representing the us"),
+    external_id: str = typer.Option(None, "--external-id", help="User identifier provided by an external provisioning source."),
+    display_name: str = typer.Option(None, "--display-name", help="The name displayed for the user in Webex."),
+    nick_name: str = typer.Option(None, "--nick-name", help="A casual name of the user. For example, Bob when the user's"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Create a user\n\nExample --json-body:\n  '{"schemas":["..."],"userName":"...","userType":"user","title":"...","active":true,"roles":[{"value":"...","type":"...","display":"..."}],"preferredLanguage":"...","locale":"..."}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if user_name is not None:
+            body["userName"] = user_name
+        if user_type is not None:
+            body["userType"] = user_type
+        if title is not None:
+            body["title"] = title
+        if active is not None:
+            body["active"] = active
+        if preferred_language is not None:
+            body["preferredLanguage"] = preferred_language
+        if locale is not None:
+            body["locale"] = locale
+        if timezone is not None:
+            body["timezone"] = timezone
+        if profile_url is not None:
+            body["profileUrl"] = profile_url
+        if external_id is not None:
+            body["externalId"] = external_id
+        if display_name is not None:
+            body["displayName"] = display_name
+        if nick_name is not None:
+            body["nickName"] = nick_name
+        _missing = [f for f in ['userName', 'userType'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+
+
+@app.command("show")
+def show(
+    user_id: str = typer.Argument(help="userId"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get a user."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users/{user_id}"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+
+
+@app.command("update")
+def update(
+    user_id: str = typer.Argument(help="userId"),
+    user_name: str = typer.Option(None, "--user-name", help="A unique identifier for the user and authenticates the user"),
+    user_type: str = typer.Option(None, "--user-type", help="Choices: user, room, external_calling, calling_service"),
+    title: str = typer.Option(None, "--title", help="The user's business title.  Examples of a title is \"Business"),
+    active: bool = typer.Option(None, "--active/--no-active", help="A boolean value of \"true\" or \"false\" indicating whether the"),
+    preferred_language: str = typer.Option(None, "--preferred-language", help="User's preferred language.  Acceptable values for this field"),
+    locale: str = typer.Option(None, "--locale", help="The user's locale which represents the user's currency, time"),
+    timezone: str = typer.Option(None, "--timezone", help="The user's time zone specified in the [IANA timezone](https:"),
+    profile_url: str = typer.Option(None, "--profile-url", help="A fully qualified URL pointing to a page representing the us"),
+    external_id: str = typer.Option(None, "--external-id", help="User identifier provided by an external provisioning source."),
+    display_name: str = typer.Option(None, "--display-name", help="The name displayed for the user in Webex."),
+    nick_name: str = typer.Option(None, "--nick-name", help="A casual name of the user. For example, Bob when the user's"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a user with PUT\n\nExample --json-body:\n  '{"schemas":["..."],"userName":"...","userType":"user","title":"...","active":true,"roles":[{"value":"...","type":"...","display":"..."}],"preferredLanguage":"...","locale":"..."}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users/{user_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if user_name is not None:
+            body["userName"] = user_name
+        if user_type is not None:
+            body["userType"] = user_type
+        if title is not None:
+            body["title"] = title
+        if active is not None:
+            body["active"] = active
+        if preferred_language is not None:
+            body["preferredLanguage"] = preferred_language
+        if locale is not None:
+            body["locale"] = locale
+        if timezone is not None:
+            body["timezone"] = timezone
+        if profile_url is not None:
+            body["profileUrl"] = profile_url
+        if external_id is not None:
+            body["externalId"] = external_id
+        if display_name is not None:
+            body["displayName"] = display_name
+        if nick_name is not None:
+            body["nickName"] = nick_name
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("update-users")
+def update_users(
+    user_id: str = typer.Argument(help="userId"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a user with PATCH\n\nExample --json-body:\n  '{"schemas":["..."],"Operations":[{"op":"...","path":"...","value":"..."}]}'."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users/{user_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    try:
+        result = api.session.rest_patch(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    user_id: str = typer.Argument(help="userId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a user."""
+    if not force:
+        typer.confirm(f"Delete {user_id}?", abort=True)
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/scim/{org_id}/v2/Users/{user_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {user_id}")
+
+
+
+@app.command("show-me")
+def show_me(
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Me."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/identity/scim/v2/Users/me"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+