wxcli 1.2.0__py3-none-any.whl

wxcli/commands/cc_callbacks.py

@@ -0,0 +1,194 @@
+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, get_cc_base_url, get_cc_org_id
+
+
+app = typer.Typer(help="Manage Webex Contact Center cc-callbacks.")
+
+
+@app.command("list")
+def cmd_list(
+    callback_number: str = typer.Option(None, "--callback-number", help="The callback customer number to filter the scheduled callbac"),
+    assignee_agent: str = typer.Option(None, "--assignee-agent", help="The unique identifier of the agent assigned to handle the ca"),
+    page: str = typer.Option(None, "--page", help="The page number to retrieve."),
+    page_size: str = typer.Option(None, "--page-size", help="The number of items per page."),
+    sort_by: str = typer.Option(None, "--sort-by", help="Choices: customerName, scheduledTime, assignedTime"),
+    sort_order: str = typer.Option(None, "--sort-order", help="Choices: asc, desc"),
+    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 scheduled callbacks."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/callbacks/organization/{org_id}/scheduled-callback"
+    params = {}
+    if callback_number is not None:
+        params["callbackNumber"] = callback_number
+    if assignee_agent is not None:
+        params["assigneeAgent"] = assignee_agent
+    if page is not None:
+        params["page"] = page
+    if page_size is not None:
+        params["pageSize"] = page_size
+    if sort_by is not None:
+        params["sortBy"] = sort_by
+    if sort_order is not None:
+        params["sortOrder"] = sort_order
+    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("data", 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(
+    customer_name: str = typer.Option(None, "--customer-name", help="(required) Name of the Customer for which callback has to be scheduled."),
+    callback_number: str = typer.Option(None, "--callback-number", help="(required) Customer's phone number for the callback. Allows an optional"),
+    timezone: str = typer.Option(None, "--timezone", help="(required) Valid IANA timezone name"),
+    schedule_date: str = typer.Option(None, "--schedule-date", help="(required) Scheduled date in ISO-8601 (YYYY-MM-DD) format. This must be"),
+    start_time: str = typer.Option(None, "--start-time", help="(required) Scheduled start time in ISO-8601 (HH:mm:ss) format. Start ti"),
+    end_time: str = typer.Option(None, "--end-time", help="(required) Scheduled end time in ISO-8601 (HH:mm:ss) format. End time m"),
+    queue_id: str = typer.Option(None, "--queue-id", help="(required) Unique identifier for the queue to which the callback is ass"),
+    callback_reason: str = typer.Option(None, "--callback-reason", help="Reason for the callback request. This is optional and can be"),
+    source_interaction: str = typer.Option(None, "--source-interaction", help="Source interaction ID for the callback. This is optional and"),
+    assignee_agent: str = typer.Option(None, "--assignee-agent", help="The unique identifier of the specific agent (CI userId), who"),
+    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"),
+):
+    """Schedule a Callback."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/callbacks/organization/{org_id}/scheduled-callback"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if customer_name is not None:
+            body["customerName"] = customer_name
+        if callback_number is not None:
+            body["callbackNumber"] = callback_number
+        if timezone is not None:
+            body["timezone"] = timezone
+        if schedule_date is not None:
+            body["scheduleDate"] = schedule_date
+        if start_time is not None:
+            body["startTime"] = start_time
+        if end_time is not None:
+            body["endTime"] = end_time
+        if queue_id is not None:
+            body["queueId"] = queue_id
+        if callback_reason is not None:
+            body["callbackReason"] = callback_reason
+        if source_interaction is not None:
+            body["sourceInteraction"] = source_interaction
+        if assignee_agent is not None:
+            body["assigneeAgent"] = assignee_agent
+        _missing = [f for f in ['customerName', 'callbackNumber', 'timezone', 'scheduleDate', 'startTime', 'endTime', 'queueId'] 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(
+    id: str = typer.Argument(help="id"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get scheduled callback by Id."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/callbacks/organization/{org_id}/scheduled-callback/{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(
+    id: str = typer.Argument(help="id"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update scheduled callback by Id."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/callbacks/organization/{org_id}/scheduled-callback/{id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    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(
+    id: str = typer.Argument(help="id"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete scheduled callback by Id."""
+    if not force:
+        typer.confirm(f"Delete {id}?", abort=True)
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/callbacks/organization/{org_id}/scheduled-callback/{id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {id}")
+
+

wxcli/commands/cc_campaign.py

@@ -0,0 +1,212 @@
+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, get_cc_base_url, get_cc_org_id
+
+
+app = typer.Typer(help="Manage Webex Contact Center cc-campaign.")
+
+
+@app.command("create")
+def create(
+    id_param: str = typer.Option(None, "--id", help="(required) The id represents the unique id with which the Campaign Requ"),
+    vendor_version: str = typer.Option(None, "--vendor-version", help="(required) Vendor specific information, maximum length 32 characters."),
+    campaign_type: str = typer.Option(None, "--campaign-type", help="(required) Type of campaign and campaignType should be one of \"progress"),
+    campaign_name: str = typer.Option(None, "--campaign-name", help="(Optional) Used if different than id, maximum length 64 char"),
+    auth_token: str = typer.Option(None, "--auth-token", help="(Not in use) The token needed by the dialer for querying rec"),
+    dialing_rate: str = typer.Option(None, "--dialing-rate", help="(required) Number of contacts to be dialed out per available Agent. For"),
+    entry_point_id: str = typer.Option(None, "--entry-point-id", help="(required) Webex Contact Center outdial entry point, maximum length 36"),
+    dialing_list_fetch_url: str = typer.Option(None, "--dialing-list-fetch-url", help="(required) URL the dialer will use to fetch the list of contacts to dia"),
+    outdial_ani: str = typer.Option(None, "--outdial-ani", help="(required) The ANI (E164)  that will be presented to the customer. Thes"),
+    record_count: str = typer.Option(None, "--record-count", help="(required) Value to indicate the recordCount the Campaign Manager expec"),
+    no_answer_ring_limit: str = typer.Option(None, "--no-answer-ring-limit", help="(Optional) Number of seconds before a dialed call from the d"),
+    max_dialing_rate: str = typer.Option(None, "--max-dialing-rate", help="Caps the maximum dialing rate per agent at this value. The r"),
+    abandon_rate_percentage: str = typer.Option(None, "--abandon-rate-percentage", help="The percentage of calls that are allowed to be abandoned. Th"),
+    predictive_correction_pace: str = typer.Option(None, "--predictive-correction-pace", help="A count of the number of live voice connections that must oc"),
+    predictive_gain: str = typer.Option(None, "--predictive-gain", help="The size of the adjustment to lines per agent each time an a"),
+    reservation_percentage: str = typer.Option(None, "--reservation-percentage", help="(Not in use) The percentage of agents to reserve within the"),
+    ivr_ports: str = typer.Option(None, "--ivr-ports", help="The number of IVR ports to use for this campaign. IVR ports"),
+    preview_offer_timeout: str = typer.Option(None, "--preview-offer-timeout", help="(Required if previewOfferTimeoutAutoAction is provided, opti"),
+    preview_offer_timeout_auto_action: str = typer.Option(None, "--preview-offer-timeout-auto-action", help="(Required if previewOfferTimeout is provided, optional other"),
+    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"),
+):
+    """Start Campaign Request\n\nExample --json-body:\n  '{"id":"...","vendorVersion":"...","campaignType":"...","dialingRate":0,"entryPointId":"...","dialingListFetchURL":"...","outdialANI":"...","recordCount":0}'."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/dialer/campaign"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if id_param is not None:
+            body["id"] = id_param
+        if vendor_version is not None:
+            body["vendorVersion"] = vendor_version
+        if campaign_type is not None:
+            body["campaignType"] = campaign_type
+        if campaign_name is not None:
+            body["campaignName"] = campaign_name
+        if auth_token is not None:
+            body["authToken"] = auth_token
+        if dialing_rate is not None:
+            body["dialingRate"] = dialing_rate
+        if entry_point_id is not None:
+            body["entryPointId"] = entry_point_id
+        if dialing_list_fetch_url is not None:
+            body["dialingListFetchURL"] = dialing_list_fetch_url
+        if outdial_ani is not None:
+            body["outdialANI"] = outdial_ani
+        if record_count is not None:
+            body["recordCount"] = record_count
+        if no_answer_ring_limit is not None:
+            body["noAnswerRingLimit"] = no_answer_ring_limit
+        if max_dialing_rate is not None:
+            body["maxDialingRate"] = max_dialing_rate
+        if abandon_rate_percentage is not None:
+            body["abandonRatePercentage"] = abandon_rate_percentage
+        if predictive_correction_pace is not None:
+            body["predictiveCorrectionPace"] = predictive_correction_pace
+        if predictive_gain is not None:
+            body["predictiveGain"] = predictive_gain
+        if reservation_percentage is not None:
+            body["reservationPercentage"] = reservation_percentage
+        if ivr_ports is not None:
+            body["ivrPorts"] = ivr_ports
+        if preview_offer_timeout is not None:
+            body["previewOfferTimeout"] = preview_offer_timeout
+        if preview_offer_timeout_auto_action is not None:
+            body["previewOfferTimeoutAutoAction"] = preview_offer_timeout_auto_action
+        _missing = [f for f in ['id', 'vendorVersion', 'campaignType', 'dialingRate', 'entryPointId', 'dialingListFetchURL', 'outdialANI', 'recordCount'] 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")
+def cmd_list(
+    campaign_id: str = typer.Option(..., "--campaign-id", help="The campaign ID for which valid campaign times are being req"),
+    agent_id: str = typer.Option(..., "--agent-id", help="The agent ID for whom valid campaign times are being request"),
+    tracking_id: str = typer.Option(None, "--tracking-id", help="Optional tracking identifier for request tracing."),
+    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 Valid Campaign Times."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    org_id = get_cc_org_id(api.session)
+    url = f"{cc_base_url}/organization/{org_id}/getValidCampaignTimes"
+    params = {}
+    if campaign_id is not None:
+        params["campaignId"] = campaign_id
+    if agent_id is not None:
+        params["agentId"] = agent_id
+    if tracking_id is not None:
+        params["trackingId"] = tracking_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("update")
+def update(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    dialing_rate: str = typer.Option(None, "--dialing-rate", help="Number of contacts to be dialed out per available Agent. For"),
+    campaign_name: str = typer.Option(None, "--campaign-name", help="(Optional) Used if different than id, maximum length 64 char"),
+    auth_token: str = typer.Option(None, "--auth-token", help="(Not in use) The token needed by the dialer for querying rec"),
+    dialing_list_fetch_url: str = typer.Option(None, "--dialing-list-fetch-url", help="URL the dialer will use to fetch the list of contacts to dia"),
+    outdial_ani: str = typer.Option(None, "--outdial-ani", help="The ANI (E164)  that will be presented to the customer. Thes"),
+    no_answer_ring_limit: str = typer.Option(None, "--no-answer-ring-limit", help="(Optional) Number of seconds before a dialed call from the d"),
+    max_dialing_rate: str = typer.Option(None, "--max-dialing-rate", help="Caps the maximum dialing rate per agent at this value. The r"),
+    reservation_percentage: str = typer.Option(None, "--reservation-percentage", help="(Not in use) The percentage of agents to reserve within the"),
+    preview_offer_timeout: str = typer.Option(None, "--preview-offer-timeout", help="(Required only if previewOfferTimeoutAutoAction is provided)"),
+    preview_offer_timeout_auto_action: str = typer.Option(None, "--preview-offer-timeout-auto-action", help="(Required only if previewOfferTimeout is provided) The autom"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update Campaign Request\n\nExample --json-body:\n  '{"dialingRate":0,"dialingListFetchURL":"...","outdialANI":"...","campaignName":"...","authToken":"...","noAnswerRingLimit":0,"maxDialingRate":0,"reservationPercentage":0}'."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/dialer/campaign/{campaign_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if dialing_rate is not None:
+            body["dialingRate"] = dialing_rate
+        if campaign_name is not None:
+            body["campaignName"] = campaign_name
+        if auth_token is not None:
+            body["authToken"] = auth_token
+        if dialing_list_fetch_url is not None:
+            body["dialingListFetchURL"] = dialing_list_fetch_url
+        if outdial_ani is not None:
+            body["outdialANI"] = outdial_ani
+        if no_answer_ring_limit is not None:
+            body["noAnswerRingLimit"] = no_answer_ring_limit
+        if max_dialing_rate is not None:
+            body["maxDialingRate"] = max_dialing_rate
+        if reservation_percentage is not None:
+            body["reservationPercentage"] = reservation_percentage
+        if preview_offer_timeout is not None:
+            body["previewOfferTimeout"] = preview_offer_timeout
+        if preview_offer_timeout_auto_action is not None:
+            body["previewOfferTimeoutAutoAction"] = preview_offer_timeout_auto_action
+    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(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Stop Campaign Request."""
+    if not force:
+        typer.confirm(f"Delete {campaign_id}?", abort=True)
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/dialer/campaign/{campaign_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {campaign_id}")
+
+

wxcli/commands/cc_captures.py

@@ -0,0 +1,39 @@
+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_cc_base_url
+
+
+app = typer.Typer(help="Manage Webex Contact Center cc-captures.")
+
+
+@app.command("create")
+def create(
+    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"),
+):
+    """List Captures\n\nExample --json-body:\n  '{"query":{"taskIds":["..."],"orgId":"...","urlExpiration":0,"includeSegments":true,"includeVARecordings":true,"includeScreenRecordings":true}}'."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/captures/query"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    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/cc_contact_list.py

@@ -0,0 +1,169 @@
+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_cc_base_url
+
+
+app = typer.Typer(help="Manage Webex Contact Center cc-contact-list.")
+
+
+@app.command("create")
+def create(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    activation_time_lag_minutes: str = typer.Option(None, "--activation-time-lag-minutes", help="Contact list activation time lag in minutes (0 = immediate a"),
+    activation_date_time: str = typer.Option(None, "--activation-date-time", help="Contact list activation DateTimeStamp (format: YYYY-MM-DDTHH"),
+    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 contact list\n\nExample --json-body:\n  '{"supportedChannels":["Voice"],"activationTimeLagMinutes":0,"activationDateTime":"..."}'."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/v3/campaign-management/campaigns/{campaign_id}/contact-list"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if activation_time_lag_minutes is not None:
+            body["activationTimeLagMinutes"] = activation_time_lag_minutes
+        if activation_date_time is not None:
+            body["activationDateTime"] = activation_date_time
+    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 "contactListId" in result:
+        typer.echo(f"Created: {result['contactListId']}")
+    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("create-contacts")
+def create_contacts(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    contact_list_id: str = typer.Argument(help="contactListId"),
+    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 contacts within a contact list\n\nExample --json-body:\n  '{"contacts":[{"contactAttributes":"..."}]}'."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/v3/campaign-management/campaigns/{campaign_id}/contact-list/{contact_list_id}/contacts"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    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("update")
+def update(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    contact_list_id: str = typer.Argument(help="contactListId"),
+    contact_id: str = typer.Argument(help="contactId"),
+    contact_status: str = typer.Option(None, "--contact-status", help="Choices: CLOSED"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a contact's status within a contact list."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/v3/campaign-management/campaigns/{campaign_id}/contact-list/{contact_list_id}/contacts/{contact_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if contact_status is not None:
+            body["contactStatus"] = contact_status
+    try:
+        result = api.session.rest_patch(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("update-status")
+def update_status(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    contact_list_id: str = typer.Argument(help="contactListId"),
+    contact_list_status: str = typer.Option(None, "--contact-list-status", help="Contact List Status (e.g., EXPIRED). Note: This value is not"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update contact list status."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/v3/campaign-management/campaigns/{campaign_id}/contact-list/{contact_list_id}/status"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if contact_list_status is not None:
+            body["contactListStatus"] = contact_list_status
+    try:
+        result = api.session.rest_patch(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("list")
+def cmd_list(
+    campaign_id: str = typer.Argument(help="campaignId"),
+    status: str = typer.Option(None, "--status", help="Choices: Active, Expired, UploadFailed"),
+    source: str = typer.Option(None, "--source", help="Choices: API, SFTP, ManualFile, GlobalUpload, GlobalSFTP"),
+    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 Contact Lists within a Campaign."""
+    api = get_api(debug=debug)
+    cc_base_url = get_cc_base_url()
+    url = f"{cc_base_url}/v3/campaign-management/campaigns/{campaign_id}/contact-lists"
+    params = {}
+    if status is not None:
+        params["status"] = status
+    if source is not None:
+        params["source"] = source
+    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("contactLists", 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)
+
+