wxcli 1.2.0__py3-none-any.whl

wxcli/commands/security_audit.py

@@ -0,0 +1,54 @@
+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 get_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling security-audit.")
+
+
+@app.command("list")
+def cmd_list(
+    start_time: str = typer.Option(..., "--start-time", help="List events which occurred after a specific date and time."),
+    end_time: str = typer.Option(..., "--end-time", help="List events which occurred before a specific date and time."),
+    actor_id: str = typer.Option(None, "--actor-id", help="List events performed by this person, by ID."),
+    event_categories: str = typer.Option(None, "--event-categories", help="List events, by event categories."),
+    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"),
+):
+    """List Security Audit Events."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/securityAudit/events"
+    params = {}
+    if start_time is not None:
+        params["startTime"] = start_time
+    if end_time is not None:
+        params["endTime"] = end_time
+    if actor_id is not None:
+        params["actorId"] = actor_id
+    if event_categories is not None:
+        params["eventCategories"] = event_categories
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    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("items", 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/service_apps.py

@@ -0,0 +1,51 @@
+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 service-apps.")
+
+
+@app.command("create")
+def create(
+    application_id: str = typer.Argument(help="applicationId"),
+    client_id: str = typer.Option(None, "--client-id", help="(required) The OAuth client ID of the Service App"),
+    client_secret: str = typer.Option(None, "--client-secret", help="(required) The OAuth client secret of the Service App"),
+    target_org_id: str = typer.Option(None, "--target-org-id", help="(required) The organization ID for which the token will be created"),
+    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 Service App Access Token."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/applications/{application_id}/token"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if client_id is not None:
+            body["clientId"] = client_id
+        if client_secret is not None:
+            body["clientSecret"] = client_secret
+        if target_org_id is not None:
+            body["targetOrgId"] = target_org_id
+        _missing = [f for f in ['clientId', 'clientSecret', 'targetOrgId'] 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/single_number_reach.py

@@ -0,0 +1,209 @@
+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 get_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling single-number-reach.")
+
+
+@app.command("list")
+def cmd_list(
+    location_id: str = typer.Argument(help="locationId"),
+    phone_number: str = typer.Option(None, "--phone-number", help="Filter phone numbers based on the comma-separated list provi"),
+    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 Single Number Reach Primary Available Phone Numbers."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/locations/{location_id}/singleNumberReach/availableNumbers"
+    params = {}
+    if phone_number is not None:
+        params["phoneNumber"] = phone_number
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    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("phoneNumbers", 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=[('Phone Number', 'phoneNumber'), ('State', 'state')], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    person_id: str = typer.Argument(help="personId"),
+    phone_number: str = typer.Option(None, "--phone-number", help="(required) Personal phone number used as single Number Reach."),
+    enabled: bool = typer.Option(None, "--enabled/--no-enabled", help="(required) A flag to enable or disable single Number Reach."),
+    name: str = typer.Option(None, "--name", help="(required) Name of the single number reach phone number entry."),
+    do_not_forward_calls_enabled: bool = typer.Option(None, "--do-not-forward-calls-enabled/--no-do-not-forward-calls-enabled", help="If enabled, the call forwarding settings of provided phone N"),
+    answer_confirmation_enabled: bool = typer.Option(None, "--answer-confirmation-enabled/--no-answer-confirmation-enabled", help="If enabled, the call recepient will be prompted to press a k"),
+    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 Single Number Reach For a Person."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/people/{person_id}/singleNumberReach/numbers"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if phone_number is not None:
+            body["phoneNumber"] = phone_number
+        if enabled is not None:
+            body["enabled"] = enabled
+        if name is not None:
+            body["name"] = name
+        if do_not_forward_calls_enabled is not None:
+            body["doNotForwardCallsEnabled"] = do_not_forward_calls_enabled
+        if answer_confirmation_enabled is not None:
+            body["answerConfirmationEnabled"] = answer_confirmation_enabled
+        _missing = [f for f in ['phoneNumber', 'enabled', 'name'] 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("list-single-number-reach")
+def list_single_number_reach(
+    person_id: str = typer.Argument(help="personId"),
+    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 Single Number Reach Settings For A Person."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/people/{person_id}/singleNumberReach"
+    params = {}
+    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("numbers", 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("update")
+def update(
+    person_id: str = typer.Argument(help="personId"),
+    alert_all_numbers_for_click_to_dial_calls_enabled: bool = typer.Option(None, "--alert-all-numbers-for-click-to-dial-calls-enabled/--no-alert-all-numbers-for-click-to-dial-calls-enabled", help="Flag to enable alerting single number reach numbers for clic"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update Single Number Reach Settings For A Person."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/people/{person_id}/singleNumberReach"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if alert_all_numbers_for_click_to_dial_calls_enabled is not None:
+            body["alertAllNumbersForClickToDialCallsEnabled"] = alert_all_numbers_for_click_to_dial_calls_enabled
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("update-numbers")
+def update_numbers(
+    person_id: str = typer.Argument(help="personId"),
+    id: str = typer.Argument(help="id"),
+    phone_number: str = typer.Option(None, "--phone-number", help="Personal phone number used as single Number Reach."),
+    enabled: bool = typer.Option(None, "--enabled/--no-enabled", help="A flag to enable or disable single Number Reach phone number"),
+    name: str = typer.Option(None, "--name", help="Name of the single number reach phone number entry."),
+    do_not_forward_calls_enabled: bool = typer.Option(None, "--do-not-forward-calls-enabled/--no-do-not-forward-calls-enabled", help="If enabled, the call forwarding settings of provided phone N"),
+    answer_confirmation_enabled: bool = typer.Option(None, "--answer-confirmation-enabled/--no-answer-confirmation-enabled", help="If enabled, the call recepient will be prompted to press a k"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update Single Number Reach Settings For A Number."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/people/{person_id}/singleNumberReach/numbers/{id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if phone_number is not None:
+            body["phoneNumber"] = phone_number
+        if enabled is not None:
+            body["enabled"] = enabled
+        if name is not None:
+            body["name"] = name
+        if do_not_forward_calls_enabled is not None:
+            body["doNotForwardCallsEnabled"] = do_not_forward_calls_enabled
+        if answer_confirmation_enabled is not None:
+            body["answerConfirmationEnabled"] = answer_confirmation_enabled
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    person_id: str = typer.Argument(help="personId"),
+    id: str = typer.Argument(help="id"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete A Single Number Reach Number."""
+    if not force:
+        typer.confirm(f"Delete {id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/people/{person_id}/singleNumberReach/numbers/{id}"
+    params = {}
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    try:
+        api.session.rest_delete(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {id}")
+
+

wxcli/commands/team_memberships.py

@@ -0,0 +1,155 @@
+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 team-memberships.")
+
+
+@app.command("list")
+def cmd_list(
+    team_id: str = typer.Option(..., "--team-id", help="List memberships for a team, by ID."),
+    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"),
+):
+    """List Team Memberships."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/team/memberships"
+    params = {}
+    if team_id is not None:
+        params["teamId"] = team_id
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    try:
+        if limit > 0:
+            result = api.session.rest_get(url, params=params)
+            result = result or {}
+            items = result.get("items", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+        else:
+            items = list(api.session.follow_pagination(url=url, params=params, item_key="items"))
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[("ID", "id"), ("Name", "name")], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    team_id: str = typer.Option(None, "--team-id", help="(required) The team ID."),
+    person_id: str = typer.Option(None, "--person-id", help="The person ID."),
+    person_email: str = typer.Option(None, "--person-email", help="The email address of the person."),
+    is_moderator: bool = typer.Option(None, "--is-moderator/--no-is-moderator", help="Whether or not the participant is a team moderator."),
+    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 Team Membership."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/team/memberships"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if team_id is not None:
+            body["teamId"] = team_id
+        if person_id is not None:
+            body["personId"] = person_id
+        if person_email is not None:
+            body["personEmail"] = person_email
+        if is_moderator is not None:
+            body["isModerator"] = is_moderator
+        _missing = [f for f in ['teamId'] 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(
+    membership_id: str = typer.Argument(help="membershipId"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Team Membership Details."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/team/memberships/{membership_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(
+    membership_id: str = typer.Argument(help="membershipId"),
+    is_moderator: bool = typer.Option(None, "--is-moderator/--no-is-moderator", help="Whether or not the participant is a team moderator."),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a Team Membership."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/team/memberships/{membership_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if is_moderator is not None:
+            body["isModerator"] = is_moderator
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    membership_id: str = typer.Argument(help="membershipId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a Team Membership."""
+    if not force:
+        typer.confirm(f"Delete {membership_id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/team/memberships/{membership_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {membership_id}")
+
+

wxcli/commands/teams.py

@@ -0,0 +1,153 @@
+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 teams.")
+
+
+@app.command("list")
+def cmd_list(
+    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"),
+):
+    """List Teams."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/teams"
+    params = {}
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    try:
+        if limit > 0:
+            result = api.session.rest_get(url, params=params)
+            result = result or {}
+            items = result.get("items", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+        else:
+            items = list(api.session.follow_pagination(url=url, params=params, item_key="items"))
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[('ID', 'id'), ('Name', 'name')], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    name: str = typer.Option(None, "--name", help="(required) A user-friendly name for the team."),
+    description: str = typer.Option(None, "--description", help="The teams description."),
+    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 Team."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/teams"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if name is not None:
+            body["name"] = name
+        if description is not None:
+            body["description"] = description
+        _missing = [f for f in ['name'] 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(
+    team_id: str = typer.Argument(help="teamId"),
+    description: str = typer.Option(None, "--description", help="The teams description."),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Team Details."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/teams/{team_id}"
+    params = {}
+    if description is not None:
+        params["description"] = description
+    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(
+    team_id: str = typer.Argument(help="teamId"),
+    name: str = typer.Option(None, "--name", help="A user-friendly name for the team."),
+    description: str = typer.Option(None, "--description", help="The teams description."),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a Team."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/teams/{team_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if name is not None:
+            body["name"] = name
+        if description is not None:
+            body["description"] = description
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    team_id: str = typer.Argument(help="teamId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a Team."""
+    if not force:
+        typer.confirm(f"Delete {team_id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/teams/{team_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {team_id}")
+
+

wxcli/commands/ucm_profile.py

@@ -0,0 +1,42 @@
+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 get_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling ucm-profile.")
+
+
+@app.command("list")
+def cmd_list(
+    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"),
+):
+    """Read the List of UC Manager Profiles."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/config/callingProfiles"
+    params = {}
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    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("callingProfiles", 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)
+
+