foxreach-cli 0.2.0__tar.gz → 0.6.0__tar.gz

foxreach_cli-0.6.0/CHANGELOG.md

@@ -0,0 +1,108 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.6.0] - 2026-11-04
+
+Requires `foxreach>=0.6.0` (the commands below import names and call methods that SDK 0.6.0 adds).
+
+### Added
+
+- `campaigns duplicate|share|preview|test-email|bulk-remove-leads|activity|cohorts|lead-emails`: copy a campaign, turn its public report page on or off, render copy, send one real test email (asks first), remove many leads, and read the activity feed and daily cohorts.
+- `sequences variants list|add|update|delete|stats --campaign ID --step ID`: A/B variants of a sequence step and a per-variant comparison.
+- `leads bulk-delete|bulk-tag|bulk-untag|bulk-verify|export|variables`: bulk lead actions by `--lead-id` or `--filter-*`, a CSV export that waits and downloads, and the merge-tag list. `bulk-delete` shows the campaigns affected and asks first; `bulk-verify` spends verification credits.
+- `workspace show|rename|members|invite|set-role|remove|invites|revoke-invite|resend-invite|defaults` and `api-keys list|create|revoke`. Team changes and key management need a key with the opt-in `admin` scope.
+- `webhooks test`, `webhooks deliveries` and `events list`.
+- `inbox mark-read`, `mark-all-read`, `bulk-update`, `bulk-delete`, `notes list|add|delete` and `sent`.
+- `agency overview|clients|create-client|rename-client|delete-client|branding|set-branding`, `audit-log list`, `analytics account|report|export-report|leaderboard|activity|campaign-daily|campaign-steps`, `lead-finder create-list|get-list|rename-list|delete-list|list-items|add-items|remove-items|reveal-list|add-list-to-leads|export-list|create-saved-search|get-saved-search|update-saved-search|delete-saved-search|run-saved-search`, `warmup create-tag|update-tag|delete-tag|assign-tag|unassign-tag`, `accounts test-connection|check-domain-auth`, `templates publish|unpublish|clone`. Each prints the API's JSON. `lead-finder reveal-list` spends reveal credits; `agency delete-client` is irreversible.
+
+- `--workspace ID` (or `FOXREACH_WORKSPACE_ID`): run any command as a client workspace of an Agency key.
+- `workspaces list`: show the workspaces the key can act as.
+- `me`: show the API key in use, its workspace, the plan, the rate limit and the credit balances.
+- `jobs list [--type T] [--status S] [--page N] [--limit N]` and `jobs get JOB_ID`: read the status, progress and result counters of background jobs (lead imports, verification runs).
+- `block-list list|add|remove|export`: manage the workspace block list. `add` takes any number of emails or domains and `--note`; `remove` takes entry IDs; `export` writes CSV to stdout or `-o FILE`.
+
+- `campaigns cohort-detail CAMPAIGN_ID DATE`: the emails and replies of one UTC day (each side cut at 200 rows).
+- `inbox drafts list|get|edit|send|regenerate|dismiss`: AI reply drafts. `send` sends the stored draft as a real email.
+- `lead-labels list|create|update|delete|assign|unassign`, `leads set-interest LEAD_ID STATUS|clear`, and `leads list --interest-status` / `--label-id`.
+- `copy judge` (free) and `copy rewrite` (1 AI credit): score or rewrite a subject and body (`--body` or `--body-file`).
+- `webhooks resume ID` (turn a webhook paused after 10 failed deliveries back on) and `webhooks create --reply-categories`.
+
+### Fixed
+
+- `lead-finder reveal` revealed nothing: it posted `{"id": ...}` for each `--person-ids` value, and the API looks a person up by name plus company or domain, so every person came back `unsearchable`. It now takes `--from-file` (the JSON printed by `lead-finder search`, a JSON list of person rows, or `-` for stdin) and posts those rows; `--person-ids` picks rows from that file. `--person-ids` without `--from-file` now exits with an error instead of spending a request.
+
+## [0.5.0] - 2026-11-03
+
+### Added
+
+- `leads create --custom KEY=VALUE` (repeatable) sets custom fields on a new lead.
+- `leads update --custom KEY=VALUE` and `--unset-custom KEY` change or remove individual custom fields; the lead's other custom fields are kept.
+- `leads import --mapping` accepts `"custom:<name>"` as a target: `{"z123": "custom:p234"}` saves the `z123` column as the custom field `p234`. Columns not in the mapping are still left out.
+- `leads list --provider VALUE`: filter leads by recipient mail provider (google, microsoft, zoho, yahoo, godaddy, other, gateway, unresolved).
+- `leads providers`: show how your leads split across mail providers, how many sit behind a security gateway, and how much has been checked.
+- `campaigns esp-mix CAMPAIGN_ID`: show how a campaign's mailboxes and leads split across mail providers.
+
+### Fixed
+
+- Table output of `inbox stats`, `inbox conversation`, `leads activity`, `verification` credits and `tracking-domains` read camelCase keys the SDK no longer returns, so counts showed 0 and sender or campaign showed blank. They now read the SDK's snake_case keys.
+
+## [0.4.2] - 2026-10-21
+
+Requires `foxreach>=0.4.2`.
+
+### Added
+
+- `leads list --email ADDRESS`: exact, case-insensitive email match.
+- `inbox get --mark-read`: mark the thread read while fetching it.
+- `sequences create --name`.
+- `templates create --category` and `templates update --category` (for example `email` or `reply_macro`).
+
+### Changed
+
+- `inbox get` no longer marks the thread read. The API stopped marking threads read on read; pass `--mark-read` (or use `inbox update ID --read`) to mark it.
+- `sequences create --subject` is now required, matching the API.
+- `sequences create --step` is removed. The API assigns the step number and ignored the value.
+- `sequences list` shows a Name column instead of Type (sequences have no type); `templates list` and `templates get` show the template's category.
+
+### Fixed
+
+- `foxreach_cli/__init__.py` said 0.4.0 while `pyproject.toml` said 0.4.1. Both now say 0.4.2, and `tests/test_request_shapes.py::test_version_sources_agree` asserts it.
+
+## [0.4.1] - 2026-10-21
+
+### Added
+
+- `campaigns list-leads <id>` — paginated leads enrolled in a campaign (`GET /campaigns/{id}/leads`)
+- `campaigns list-accounts <id>` — email accounts assigned to a campaign (`GET /campaigns/{id}/accounts`)
+- `accounts google-oauth-start` — start Google Workspace OAuth flow; returns a redirect URL (`POST /email-accounts/google-oauth/start`)
+- `lead-finder filter-options` — available filter keys, industries, and countries (`GET /lead-finder/filter-options`)
+- `lead-finder count` — count people matching filters without using a search page (`POST /lead-finder/count`)
+- `lead-finder companies-count` — count companies matching filters (`POST /lead-finder/companies/count`)
+- `lead-finder companies-search` — search companies by filters (`POST /lead-finder/companies/search`)
+- `lead-finder add-to-leads` — move revealed contacts into leads workspace (`POST /lead-finder/add-to-leads`)
+- `lead-finder reveals-get <batch_id>` — get a single reveal batch (`GET /lead-finder/reveals/{batch_id}`)
+- `leads import` — bulk import leads from a CSV file with column mapping (`POST /leads/import`)
+- `managed-inboxes domains-search <query>` — search available domains by keyword (`GET /managed-inboxes/domains/search`)
+- `managed-inboxes domains-suggest <domain>` — get domain name suggestions (`GET /managed-inboxes/domains/suggest`)
+- `managed-inboxes quote` — get a price quote for a managed inbox order (`POST /managed-inboxes/orders/quote`)
+- `managed-inboxes get-order <order_id>` — get a managed inbox order by ID (`GET /managed-inboxes/orders/{id}`)
+
+### Changed
+
+- CLI test mocks are now spec'd with `create_autospec` on resource classes so a renamed SDK method call fails the test with `AttributeError` instead of silently passing.
+
+## [0.4.0] - 2026-10-21
+
+### Added
+- New command groups: `warmup` (pool/stats/logs/tags), `lead-finder` (credits/search/reveal/reveals/lists/saved-searches), `managed-inboxes` (config/check-domain/orders/mailboxes), `tracking-domains` (list/add/verify/delete)
+- New commands on `accounts`: `create`, `update`, `reconnect`, `enable-warmup`, `disable-warmup`, `health`, `warmup`
+- New command on `inbox`: `delete`
+- New command on `leads`: `tags`
+
+### Fixed
+- Single version source: `__version__` in `foxreach_cli/__init__.py`; `pyproject.toml` aligned to 0.4.0
+- Dependency bumped from `foxreach>=0.2.0` to `foxreach>=0.4.0`
+
+### Notes
+- PyPI publishing is pending; not yet published to pypi.org

{foxreach_cli-0.2.0 → foxreach_cli-0.6.0}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: foxreach-cli
-Version: 0.2.0
+Version: 0.6.0
 Summary: CLI for the FoxReach cold email outreach API
 Project-URL: Homepage, https://foxreach.io
-Project-URL: Documentation, https://docs.foxreach.io/sdks/cli
+Project-URL: Documentation, https://www.foxreach.io/docs/sdks/cli
 Project-URL: Repository, https://github.com/foxreach/foxreach-cli
-Project-URL: Changelog, https://docs.foxreach.io/changelog
+Project-URL: Changelog, https://www.foxreach.io/docs/changelog
 Author-email: FoxReach <dev@foxreach.io>
 License: MIT
 License-File: LICENSE
@@ -23,8 +23,11 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Email
 Requires-Python: >=3.9
 Requires-Dist: click>=8.0
-Requires-Dist: foxreach>=0.2.0
+Requires-Dist: foxreach>=0.6.0
 Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.20; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # FoxReach CLI
@@ -62,6 +65,7 @@ export FOXREACH_BASE_URL=https://api.foxreach.io/api/v1  # optional
 ```bash
 foxreach leads list
 foxreach leads list --search "jane" --status active
+foxreach leads list --email jane@example.com   # exact, case-insensitive match
 foxreach leads get cld_abc123
 foxreach leads create --email jane@example.com --first-name Jane --company "Acme"
 foxreach leads update cld_abc123 --company "New Corp"
@@ -115,7 +119,8 @@ foxreach accounts delete acc_abc123
 ```bash
 foxreach inbox list
 foxreach inbox list --unread --category interested
-foxreach inbox get rpl_abc123
+foxreach inbox get rpl_abc123              # does not mark the thread read
+foxreach inbox get rpl_abc123 --mark-read  # marks it read
 foxreach inbox update rpl_abc123 --read --category qualified
 ```
 

{foxreach_cli-0.2.0 → foxreach_cli-0.6.0}/README.md

@@ -33,6 +33,7 @@ export FOXREACH_BASE_URL=https://api.foxreach.io/api/v1  # optional
 ```bash
 foxreach leads list
 foxreach leads list --search "jane" --status active
+foxreach leads list --email jane@example.com   # exact, case-insensitive match
 foxreach leads get cld_abc123
 foxreach leads create --email jane@example.com --first-name Jane --company "Acme"
 foxreach leads update cld_abc123 --company "New Corp"
@@ -86,7 +87,8 @@ foxreach accounts delete acc_abc123
 ```bash
 foxreach inbox list
 foxreach inbox list --unread --category interested
-foxreach inbox get rpl_abc123
+foxreach inbox get rpl_abc123              # does not mark the thread read
+foxreach inbox get rpl_abc123 --mark-read  # marks it read
 foxreach inbox update rpl_abc123 --read --category qualified
 ```
 

{foxreach_cli-0.2.0 → foxreach_cli-0.6.0}/foxreach_cli/__init__.py

@@ -1,3 +1,3 @@
 """FoxReach CLI — command-line interface for the FoxReach API."""
 
-__version__ = "0.1.0"
+__version__ = "0.6.0"

{foxreach_cli-0.2.0 → foxreach_cli-0.6.0}/foxreach_cli/client_factory.py

@@ -8,6 +8,14 @@ from . import config as cfg
 from .output import print_error
 
 
+_workspace_id: str | None = None
+
+
+def set_workspace(workspace_id: str | None) -> None:
+    global _workspace_id
+    _workspace_id = workspace_id or None
+
+
 def get_client() -> FoxReach:
     api_key = cfg.get_api_key()
     if not api_key:
@@ -19,4 +27,7 @@ def get_client() -> FoxReach:
     if base_url:
         kwargs["base_url"] = base_url
 
+    if _workspace_id:
+        kwargs["workspace_id"] = _workspace_id
+
     return FoxReach(**kwargs)

foxreach_cli-0.6.0/foxreach_cli/commands/accounts.py

@@ -0,0 +1,305 @@
+from __future__ import annotations
+
+import sys
+from dataclasses import asdict
+from typing import Optional
+
+import click
+
+from foxreach import EmailAccountCreate, EmailAccountUpdate, FoxReachError, ReconnectRequest
+
+from ..client_factory import get_client
+from ..output import print_detail, print_error, print_json, print_meta, print_success, print_table
+
+
+@click.group()
+def accounts() -> None:
+    """Manage email accounts."""
+
+
+@accounts.command("list")
+@click.option("--page", default=1, type=int)
+@click.option("--limit", default=50, type=int)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_list(page: int, limit: int, as_json: bool) -> None:
+    """List email accounts."""
+    client = get_client()
+    try:
+        result = client.email_accounts.list(page=page, page_size=limit)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json({"data": [asdict(a) for a in result.data], "meta": asdict(result.meta)})
+        return
+
+    if not result.data:
+        click.echo("No email accounts found.")
+        return
+
+    print_table(
+        result.data,
+        ["ID", "Email", "Display Name", "Active", "Daily Limit", "Sent Today", "Health"],
+        {
+            "ID": "id", "Email": "email", "Display Name": "display_name",
+            "Active": "is_active", "Daily Limit": "daily_limit",
+            "Sent Today": "sent_today", "Health": "health_score",
+        },
+    )
+    print_meta(result.meta)
+
+
+@accounts.command("get")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_get(account_id: str, as_json: bool) -> None:
+    """Get an email account by ID."""
+    client = get_client()
+    try:
+        account = client.email_accounts.get(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(account)
+        return
+
+    print_detail(account, [
+        "id", "email", "display_name", "provider", "is_active",
+        "daily_limit", "sent_today", "warmup_enabled",
+        "health_score", "bounce_rate", "reply_rate",
+        "connection_status", "created_at",
+    ])
+
+
+@accounts.command("delete")
+@click.argument("account_id")
+@click.confirmation_option(prompt="Are you sure you want to delete this email account?")
+def accounts_delete(account_id: str) -> None:
+    """Delete an email account."""
+    client = get_client()
+    try:
+        client.email_accounts.delete(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Email account deleted: {account_id}")
+
+
+@accounts.command("create")
+@click.option("--email", required=True, help="Email address")
+@click.option("--password", required=True, hide_input=True, help="App password")
+@click.option("--smtp-host", required=True, help="SMTP host")
+@click.option("--smtp-port", required=True, type=int, help="SMTP port")
+@click.option("--imap-host", required=True, help="IMAP host")
+@click.option("--imap-port", required=True, type=int, help="IMAP port")
+@click.option("--provider", default="other", help="Provider (gmail/outlook/other)")
+@click.option("--display-name", default=None, help="Display name")
+@click.option("--daily-limit", default=None, type=int, help="Daily send limit")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_create(
+    email: str,
+    password: str,
+    smtp_host: str,
+    smtp_port: int,
+    imap_host: str,
+    imap_port: int,
+    provider: str,
+    display_name: Optional[str],
+    daily_limit: Optional[int],
+    as_json: bool,
+) -> None:
+    """Create a new email account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.create(EmailAccountCreate(
+            email=email,
+            password=password,
+            smtp_host=smtp_host,
+            smtp_port=smtp_port,
+            imap_host=imap_host,
+            imap_port=imap_port,
+            provider=provider,
+            display_name=display_name,
+            daily_limit=daily_limit,
+        ))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account created: {account.id} ({account.email})")
+
+
+@accounts.command("update")
+@click.argument("account_id")
+@click.option("--display-name", default=None, help="Display name")
+@click.option("--daily-limit", default=None, type=int, help="Daily send limit")
+@click.option("--timezone", default=None, help="Timezone")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_update(
+    account_id: str,
+    display_name: Optional[str],
+    daily_limit: Optional[int],
+    timezone: Optional[str],
+    as_json: bool,
+) -> None:
+    """Update an email account's settings. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.update(account_id, EmailAccountUpdate(
+            display_name=display_name,
+            daily_limit=daily_limit,
+            timezone=timezone,
+        ))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account updated: {account_id}")
+
+
+@accounts.command("reconnect")
+@click.argument("account_id")
+@click.option("--password", required=True, hide_input=True, help="New app password")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_reconnect(account_id: str, password: str, as_json: bool) -> None:
+    """Reconnect an account with a new app password. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.reconnect(account_id, ReconnectRequest(password=password))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account reconnected: {account_id}")
+
+
+@accounts.command("enable-warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_enable_warmup(account_id: str, as_json: bool) -> None:
+    """Enable warmup for an account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.enable_warmup(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Warmup enabled: {account_id}")
+
+
+@accounts.command("disable-warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_disable_warmup(account_id: str, as_json: bool) -> None:
+    """Disable warmup for an account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.disable_warmup(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Warmup disabled: {account_id}")
+
+
+@accounts.command("health")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_health(account_id: str, as_json: bool) -> None:
+    """Get deliverability and warmup health metrics for an account."""
+    client = get_client()
+    try:
+        h = client.email_accounts.health(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json({
+            "healthScore": h.health_score,
+            "warmupEnabled": h.warmup_enabled,
+        })
+        return
+
+    score = h.health_score if h.health_score is not None else "—"
+    click.echo(f"  Health Score:  {score}")
+    click.echo(f"  Warmup:        {h.warmup_enabled}")
+
+
+@accounts.command("warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, default=True, help="Output as JSON (default)")
+def accounts_warmup(account_id: str, as_json: bool) -> None:
+    """Get warmup progress and pool stats for an account."""
+    client = get_client()
+    try:
+        result = client.email_accounts.warmup_detail(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@accounts.command("google-oauth-start")
+@click.option("--json", "as_json", is_flag=True, default=True, help="Output as JSON (default)")
+def accounts_google_oauth_start(as_json: bool) -> None:
+    """Start Google OAuth flow. Returns a browser redirect URL to complete the connection."""
+    client = get_client()
+    try:
+        result = client.email_accounts.google_oauth_start()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@accounts.command("test-connection")
+@click.argument("email")
+@click.argument("password")
+@click.argument("smtp_host")
+@click.argument("imap_host")
+@click.option("--smtp-port", "smtp_port", default=None)
+@click.option("--imap-port", "imap_port", default=None)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_test_connection(email, password, smtp_host, imap_host, smtp_port, imap_port, as_json: bool) -> None:
+    """Check SMTP and IMAP login for a mailbox without saving anything. The password goes to the mail provider only. Requires write scope."""
+    client = get_client()
+    try:
+        result = client.email_accounts.test_connection(email, password, smtp_host, imap_host, smtp_port=smtp_port, imap_port=imap_port)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@accounts.command("check-domain-auth")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_check_domain_auth(account_id, as_json: bool) -> None:
+    """Run a fresh SPF, DKIM and DMARC check for an account's sending domain. Requires write scope."""
+    client = get_client()
+    try:
+        result = client.email_accounts.check_domain_auth(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)

foxreach_cli-0.6.0/foxreach_cli/commands/agency.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+import sys
+
+import click
+
+from foxreach import FoxReachError
+
+from ..client_factory import get_client
+from ..output import print_error, print_json
+
+
+@click.group("agency")
+def agency() -> None:
+    """Agency client workspaces and stored branding settings (Agency keys only)."""
+
+
+@agency.command("overview")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_overview(as_json: bool) -> None:
+    """Totals across every client workspace. Requires read scope on an Agency key."""
+    client = get_client()
+    try:
+        result = client.agency.overview()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("clients")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_clients(as_json: bool) -> None:
+    """List the agency owner's workspaces with health and usage. Requires read scope."""
+    client = get_client()
+    try:
+        result = client.agency.list_clients()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("create-client")
+@click.argument("name")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_create_client(name, as_json: bool) -> None:
+    """Create a client workspace. Needs a key created by the agency owner."""
+    client = get_client()
+    try:
+        result = client.agency.create_client(name)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("rename-client")
+@click.argument("client_id")
+@click.argument("name")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_rename_client(client_id, name, as_json: bool) -> None:
+    """Rename a client workspace. Needs a key created by the agency owner."""
+    client = get_client()
+    try:
+        result = client.agency.rename_client(client_id, name)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("delete-client")
+@click.argument("client_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_delete_client(client_id, as_json: bool) -> None:
+    """Permanently delete a client workspace and its data. Irreversible."""
+    client = get_client()
+    try:
+        result = client.agency.delete_client(client_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("branding")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_branding(as_json: bool) -> None:
+    """Read the stored branding settings (not applied to client workspaces yet). Requires read scope."""
+    client = get_client()
+    try:
+        result = client.agency.get_branding()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@agency.command("set-branding")
+@click.option("--brand-name", "brand_name", default=None)
+@click.option("--logo-url", "logo_url", default=None)
+@click.option("--favicon-url", "favicon_url", default=None)
+@click.option("--primary-color", "primary_color", default=None)
+@click.option("--accent-color", "accent_color", default=None)
+@click.option("--hide-watermark", "hide_watermark", default=None)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def agency_set_branding(brand_name, logo_url, favicon_url, primary_color, accent_color, hide_watermark, as_json: bool) -> None:
+    """Change the branding fields you pass. Needs a key created by the agency owner."""
+    client = get_client()
+    try:
+        result = client.agency.update_branding(brand_name=brand_name, logo_url=logo_url, favicon_url=favicon_url, primary_color=primary_color, accent_color=accent_color, hide_watermark=hide_watermark)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)