wxcli 1.2.0__py3-none-any.whl

wxcli/commands/meeting_reports.py

@@ -0,0 +1,101 @@
+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 Meetings meeting-reports.")
+
+
+@app.command("list")
+def cmd_list(
+    site_url: str = typer.Option(..., "--site-url", help="URL of the Webex site which the API lists meeting usage repo"),
+    service_type: str = typer.Option(None, "--service-type", help="Meeting usage report's service-type. If `serviceType` is spe"),
+    from_param: str = typer.Option(None, "--from", help="Starting date and time for meeting usage reports to return,"),
+    to: str = typer.Option(None, "--to", help="Ending date and time for meeting usage reports to return, in"),
+    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 Meeting Usage Reports."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/meetingReports/usage"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    if service_type is not None:
+        params["serviceType"] = service_type
+    if from_param is not None:
+        params["from"] = from_param
+    if to is not None:
+        params["to"] = to
+    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("list-attendees")
+def list_attendees(
+    site_url: str = typer.Option(..., "--site-url", help="URL of the Webex site which the API lists meeting attendee r"),
+    from_param: str = typer.Option(None, "--from", help="Starting date and time for the meeting attendee reports to r"),
+    to: str = typer.Option(None, "--to", help="Ending date and time for the meeting attendee reports to ret"),
+    meeting_id: str = typer.Option(None, "--meeting-id", help="Meeting ID for the meeting attendee reports to return. If sp"),
+    meeting_number: str = typer.Option(None, "--meeting-number", help="Meeting number for the meeting attendee reports to return. I"),
+    meeting_title: str = typer.Option(None, "--meeting-title", help="Meeting title for the meeting attendee reports to return. If"),
+    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 Meeting Attendee Reports."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/meetingReports/attendees"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    if from_param is not None:
+        params["from"] = from_param
+    if to is not None:
+        params["to"] = to
+    if meeting_id is not None:
+        params["meetingId"] = meeting_id
+    if meeting_number is not None:
+        params["meetingNumber"] = meeting_number
+    if meeting_title is not None:
+        params["meetingTitle"] = meeting_title
+    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)
+
+

wxcli/commands/meeting_session_types.py

@@ -0,0 +1,105 @@
+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 Meetings meeting-session-types.")
+
+
+@app.command("list")
+def cmd_list(
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site to query. If siteUrl is not specified,"),
+    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 Site Session Types."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/sessionTypes"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    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("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'), ('Type', 'type')], limit=limit)
+
+
+
+@app.command("list-session-types")
+def list_session_types(
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site to query."),
+    person_id: str = typer.Option(None, "--person-id", help="A unique identifier for the user."),
+    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 User Session Type."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/userconfig/sessionTypes"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    if person_id is not None:
+        params["personId"] = person_id
+    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("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'), ('Type', 'type')], limit=limit)
+
+
+
+@app.command("update")
+def update(
+    site_url: str = typer.Option(None, "--site-url", help="Site URL for the session type."),
+    person_id: str = typer.Option(None, "--person-id", help="A unique identifier for the user."),
+    email: str = typer.Option(None, "--email", help="The email of the user."),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update User Session Types\n\nExample --json-body:\n  '{"siteUrl":"...","sessionTypeIds":["..."],"personId":"...","email":"..."}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/userconfig/sessionTypes"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if site_url is not None:
+            body["siteUrl"] = site_url
+        if person_id is not None:
+            body["personId"] = person_id
+        if email is not None:
+            body["email"] = email
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+

wxcli/commands/meeting_site.py

@@ -0,0 +1,57 @@
+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 Meetings meeting-site.")
+
+
+@app.command("show")
+def show(
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site which the API queries common settings"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Meeting Common Settings Configuration."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/commonSettings"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    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(
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update Meeting Common Settings Configuration\n\nExample --json-body:\n  '{"siteOptions":{"allowCustomPersonalRoomURL":true},"defaultSchedulerOptions":{"entryAndExitTone":"NoTone","telephonySupport":"None","joinTeleconfNotPress1":true,"tollFree":true,"VoIP":true},"scheduleMeetingOptions":{"emailReminders":true},"securityOptions":{"joinBeforeHost":true,"audioBeforeHost":true,"firstAttendeeAsPresenter":true,"unlistAllMeetings":true,"requireLoginBeforeAccess":true,"allowMobileScreenCapture":true,"requireStrongPassword":true,"passwordCriteria":{"mixedCase":"...","minLength":"...","minNumeric":"...","minAlpha":"...","minSpecial":"...","disallowDynamicWebText":"...","disallowList":"...","disallowValues":"..."}}}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/commonSettings"
+    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.")
+
+

wxcli/commands/meeting_slido.py

@@ -0,0 +1,44 @@
+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 Meetings meeting-slido.")
+
+
+@app.command("list")
+def cmd_list(
+    session_org_id: str = typer.Option(..., "--session-org-id", help="Webex organization UUID."),
+    session_id: str = typer.Option(..., "--session-id", help="Webex meeting instance ID (`{meetingSeriesId}_I_{conferenceI"),
+    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 Compliance Events."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/slido/compliance/events"
+    params = {}
+    if session_org_id is not None:
+        params["sessionOrgId"] = session_org_id
+    if session_id is not None:
+        params["sessionId"] = session_id
+    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("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/meeting_summaries.py

@@ -0,0 +1,92 @@
+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 Meetings meeting-summaries.")
+
+
+@app.command("list")
+def cmd_list(
+    meeting_id: str = typer.Option(None, "--meeting-id", help="Unique identifier for the [meeting instance](/docs/meetings#"),
+    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 Summary by Meeting ID."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/meetingSummaries"
+    params = {}
+    if meeting_id is not None:
+        params["meetingId"] = meeting_id
+    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("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)
+
+
+
+@app.command("list-meeting-summaries")
+def list_meeting_summaries(
+    meeting_id: str = typer.Option(None, "--meeting-id", help="Unique identifier for the [meeting instance](/docs/meetings#"),
+    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 Summary For Compliance Officer."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meetingSummaries"
+    params = {}
+    if meeting_id is not None:
+        params["meetingId"] = meeting_id
+    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("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)
+
+
+
+@app.command("delete")
+def delete(
+    summary_id: str = typer.Argument(help="summaryId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a Summary."""
+    if not force:
+        typer.confirm(f"Delete {summary_id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/meetingSummaries/{summary_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {summary_id}")
+
+

wxcli/commands/meeting_tracking_codes.py

@@ -0,0 +1,233 @@
+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 Meetings meeting-tracking-codes.")
+
+
+@app.command("list")
+def cmd_list(
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site which the API retrieves the tracking c"),
+    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 Tracking Codes."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/trackingCodes"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    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("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=[('Name', 'name'), ('Site URL', 'siteUrl'), ('Service', 'service')], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    name: str = typer.Option(None, "--name", help="(required) Name for tracking code. The name cannot be empty and the max"),
+    site_url: str = typer.Option(None, "--site-url", help="(required) Site URL for the tracking code."),
+    input_mode: str = typer.Option(None, "--input-mode", help="(required) Choices: text, select, editableSelect, hostProfileSelect"),
+    host_profile_code: str = typer.Option(None, "--host-profile-code", help="(required) Choices: optional, required, adminSet, notUsed"),
+    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 Tracking Code\n\nExample --json-body:\n  '{"name":"...","siteUrl":"...","options":[{"value":"...","defaultValue":"..."}],"inputMode":"text","hostProfileCode":"optional","scheduleStartCodes":[{"service":"...","type":"..."}]}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/trackingCodes"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if name is not None:
+            body["name"] = name
+        if site_url is not None:
+            body["siteUrl"] = site_url
+        if input_mode is not None:
+            body["inputMode"] = input_mode
+        if host_profile_code is not None:
+            body["hostProfileCode"] = host_profile_code
+        _missing = [f for f in ['name', 'siteUrl', 'inputMode', 'hostProfileCode'] 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(
+    tracking_code_id: str = typer.Argument(help="trackingCodeId"),
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site which the API retrieves the tracking c"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get a Tracking Code."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/trackingCodes/{tracking_code_id}"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    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(
+    name: str = typer.Option(None, "--name", help="Name for tracking code. The name cannot be empty and the max"),
+    site_url: str = typer.Option(None, "--site-url", help="Site URL for the tracking code."),
+    input_mode: str = typer.Option(None, "--input-mode", help="Choices: text, select, editableSelect, hostProfileSelect"),
+    host_profile_code: str = typer.Option(None, "--host-profile-code", help="Choices: optional, required, adminSet, notUsed"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a Tracking Code\n\nExample --json-body:\n  '{"name":"...","siteUrl":"...","options":[{"value":"...","defaultValue":"..."}],"inputMode":"text","hostProfileCode":"optional","scheduleStartCodes":[{"service":"...","type":"..."}]}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/trackingCodes/{trackingCodeId}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if name is not None:
+            body["name"] = name
+        if site_url is not None:
+            body["siteUrl"] = site_url
+        if input_mode is not None:
+            body["inputMode"] = input_mode
+        if host_profile_code is not None:
+            body["hostProfileCode"] = host_profile_code
+    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(
+    tracking_code_id: str = typer.Argument(help="trackingCodeId"),
+    site_url: str = typer.Option(..., "--site-url", help="URL of the Webex site from which the API deletes the trackin"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a Tracking Code."""
+    if not force:
+        typer.confirm(f"Delete {tracking_code_id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/config/trackingCodes/{tracking_code_id}"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    try:
+        api.session.rest_delete(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {tracking_code_id}")
+
+
+
+@app.command("list-tracking-codes")
+def list_tracking_codes(
+    site_url: str = typer.Option(None, "--site-url", help="URL of the Webex site from which the API retrieves the track"),
+    person_id: str = typer.Option(None, "--person-id", help="Unique identifier for the user whose tracking codes are bein"),
+    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 User Tracking Codes."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/userconfig/trackingCodes"
+    params = {}
+    if site_url is not None:
+        params["siteUrl"] = site_url
+    if person_id is not None:
+        params["personId"] = person_id
+    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("trackingCodes", 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=[('Name', 'name'), ('Site URL', 'siteUrl'), ('Service', 'service')], limit=limit)
+
+
+
+@app.command("update-tracking-codes")
+def update_tracking_codes(
+    site_url: str = typer.Option(None, "--site-url", help="Site URL for the tracking code."),
+    person_id: str = typer.Option(None, "--person-id", help="Unique identifier for the user. At least one parameter of `p"),
+    email: str = typer.Option(None, "--email", help="Email address for the user. At least one parameter of `perso"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update User Tracking Codes\n\nExample --json-body:\n  '{"siteUrl":"...","personId":"...","email":"...","trackingCodes":[{"name":"...","value":"..."}]}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/admin/meeting/userconfig/trackingCodes"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if site_url is not None:
+            body["siteUrl"] = site_url
+        if person_id is not None:
+            body["personId"] = person_id
+        if email is not None:
+            body["email"] = email
+    try:
+        result = api.session.rest_put(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+