> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > CloudX CLI release history ## \[0.36] - 2026-07-17 ### Impression-level revenue exports CloudX CLI 0.36 adds asynchronous, full-day impression revenue exports for account-scoped analysis and reconciliation. ### Added * **Impression-level CSV exports** — Added `cloudx report impressions export --date YYYY-MM-DD` to create or reuse a gzip-compressed CSV containing one row per impression. Completed UTC days from the previous 45 days are supported. [Read the docs →](/en/cli/reporting#cloudx-report-impressions-export) * **Focused export filters** — Filter by app ID or bundle, ad unit ID, country, device OS, bidder, line item, and production/test traffic. * **Asynchronous download workflow** — Use `--wait` to poll for completion or `--output ` to wait and securely download the result from a short-lived URL. ```bash theme={null} cloudx report impressions export --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz ``` ## \[0.35] - 2026-06-26 ### A/B test country targeting CloudX CLI 0.35 lets A/B test config edits set geo targeting for the test variant directly from the terminal. ### Added * **A/B test geo targeting** — Added `--country` to `cloudx config edit create-ab-test` and `cloudx config edit update-ab-test`. The flag accepts repeated or comma-separated ISO 3166-1 alpha-2 or alpha-3 country codes, and CloudX stores the test-variant targeting as alpha-3 codes. [Read the docs →](/en/cli/configuration#ab-tests) ```bash theme={null} cloudx config edit create-ab-test --ad-unit-id au_123 --name "US/GB test" --country US --country GB ``` ## \[0.34] - 2026-05-29 ### Expanded config writes CloudX CLI 0.34 extends `cloudx config edit` beyond line items to cover apps, ad units, ad unit groups, lists, tags, test devices, network mappings, and A/B test lifecycle commands. ### Added * **Draft inventory edits** — Added create, update, delete, and upsert commands for the main inventory entities. Draft edits validate automatically and still require `cloudx config publish` unless noted. [Read the docs →](/en/cli/configuration#cloudx-config-edit) * **A/B test writes** — Added A/B test create, update, start, end, promote, and delete commands. Lifecycle changes publish the resulting config immediately. [Read the docs →](/en/cli/configuration#cloudx-config-edit) ## \[0.33] - 2026-05-21 ### Config validation, line-item edits, and publishing CloudX CLI 0.33 adds the ability to edit line items directly from your configuration workflow, publish reviewed drafts, and validate local YAML files or remote configs. To update an existing Homebrew installation to this release: ```bash theme={null} brew upgrade cloudx ``` ### Added * **Config validation** — Added `cloudx config validate [file]` for validating local YAML files, plus remote validation of the live config, a published version, or a draft by ID. Use `--strict` to fail on warnings. [Read the docs →](/en/cli/configuration#cloudx-config-validate) * **Line-item writes** — Added `cloudx config edit create-line-item`, `cloudx config edit update-line-item`, and `cloudx config edit delete-line-item` for preparing line-item changes in a draft config. Draft edits run validation and never publish automatically. [Read the docs →](/en/cli/configuration#cloudx-config-edit) * **Configuration publishing** — Added `cloudx config publish --id ` to publish a validated draft as the live config. [Read the docs →](/en/cli/configuration#cloudx-config-publish) * **CLI upgrade notice** — The CLI now shows a terminal notice when the CloudX API reports that a newer CLI version is available, with a link to update instructions. ## \[0.32] - 2026-05-13 To update an existing Homebrew installation to this release: ```bash theme={null} brew upgrade cloudx ``` ### Added * **API-key authentication** — `CLOUDX_API_KEY` support for CI, scheduled jobs, scripts, and other non-interactive workflows. API keys are managed by administrators in Settings > API Keys. [Read the docs →](/en/cli/authentication#api-key) * **CloudX breakdown reporting** — `cloudx report breakdown --by --metrics ` for CloudX-only aggregate reporting across requests, impressions, revenue, fill rate, eCPM, clicks, and CTR. * **Report granularity and controls** — `cloudx report dashboard` and `cloudx report export` support `--granularity daily|hourly`; breakdown reports add hourly buckets, sorting, and filters with `--granularity hourly`, `--top`, `--bottom`, and `--having`. * **Configurable request timeout** — Global `cloudx --timeout ` for API requests. The default remains `1m`, and values are capped at `2m`. [Read the docs →](/en/cli#root-flags) ## \[0.31] - 2026-05-07 ### Cross-mediator report sources CloudX CLI 0.31 adds report source filtering for publishers that forward impression-level revenue data from external mediation platforms. Existing report commands stay CloudX-only by default, and `--source` can be used to opt into mediator ILRD where supported. To update an existing Homebrew installation to this release: ```bash theme={null} brew upgrade cloudx ``` ### Added * **Report source filtering** — Added `--source` to `cloudx report dashboard`, `cloudx report apps`, and `cloudx report ad-units`. Use `--source all` for CloudX plus all available external mediator sources, `--source applovin` for one mediator, or `--source cloudx,applovin` for side-by-side comparison. * **Source-aware report metrics** — Dashboard, app, and ad-unit reports can now include external mediator ILRD for revenue, impressions, eCPM, and revenue share. Fill rate remains CloudX-only when external mediators are included because external ILRD does not include CloudX request counts. * **Clearer source semantics** — `--source` uses the mediator/platform source from ILRD, such as `applovin`, not downstream demand network names such as `ADMOB_BIDDING`. [Read the docs →](/en/cli/reporting#source-values) ## \[0.30] - 2026-05-06 ### Auction list performance and timeout handling CloudX CLI 0.30 focuses on making auction inspection more reliable during heavier searches and making timeout failures easier to understand. To update an existing Homebrew installation to this release: ```bash theme={null} brew upgrade cloudx ``` ### Improved * **Faster auction lists with ILRD filters** — Improved `cloudx auction list` performance when working with ILRD-heavy searches, especially when narrowing results by external ILRD and mediator. * **Longer default request timeout** — Increased the default CLI timeout to 60 seconds, giving heavier requests more time to complete. * **Clearer timeout errors** — Timeout failures now show a clearer CLI message instead of a low-level networking error. * **Better timeout visibility** — Timed-out CLI requests are easier for CloudX support to identify and diagnose. ## \[0.29] - 2026-05-05 ### Auction and config inspection CloudX CLI 0.29 expands the terminal workflow from reporting into production debugging. You can now inspect auctions, rounds, bids, ILRD payloads, live configs, drafts, and published config history without switching to the dashboard. To update an existing Homebrew installation to this release: ```bash theme={null} brew upgrade cloudx ``` ### Added * **Auction inspection** — Added `cloudx auction list`, `cloudx auction show`, `cloudx auction rounds`, and `cloudx auction bids` for reviewing auction records, related rows, aggregate round metrics, bid and non-bid rows, floor sources, CloudX ILRD, and opted-in external mediator ILRD. [Read the docs →](/en/cli/auction-inspection) * **Config inspection** — Added `cloudx config show` for live configs, published versions, drafts, and config rows addressed by ID, with YAML output by default and JSON output for automation. [Read the docs →](/en/cli/configuration) * **Config history** — Added `cloudx config history` for published config history, creator filtering, recent-change filtering, draft inclusion, and publish-time diff summaries. * **Workflow examples** — Updated CLI examples and overview pages with auction, config, JSON, and combined reporting workflows. [See examples →](/en/cli/examples) ## \[0.28] - 2026-04-22 ### CloudX in your terminal CLI dashboard report Some questions don't need a browser. With the new **CloudX CLI**, your daily numbers are one keystroke away — `cloudx report dashboard` shows revenue, fill rate, eCPM, and trends right next to your prompt. Filter by country, platform, ad unit, or test traffic the same way you would in the dashboard. When you need data downstream, switch to `--json` for structured output or `cloudx report export` for CSV ready to pipe into a spreadsheet, a notebook, or another tool. Install with `brew install cloudx`, sign in once, and your reporting workflow follows you wherever you work. [Read the docs →](/en/cli)