Changelog/Improvement

Keep only what matters using search-based retention rules

Jun 19 2025

You can now use Cloudsmith’s package search syntax to refine the scope of your repository's retention rules when configuring them via the Cloudsmith API. This flexible query language lets you filter packages by tag, version, downloads, and more, making it easier to target exactly which packages to keep or remove.

By using the retention_package_query_string field when setting up your repository’s retention rules, you can apply policies to a specific subset of packages within the repository, such as:

  • Packages with no tags
  • Packages without a specific tag
  • Packages with fewer than 10 downloads

You can include multiple search filters, which work alongside existing configuration options like age limits, to enable smarter and more tailored retention policies. For example:

  • Delete packages that are older than 30 days AND have no tags AND have never been downloaded.

Sample query

Here is a sample query that deletes packages older than 180 days that do not have a "production" tag:

curl --request PATCH \
     --url https://api.cloudsmith.io/v1/repos/cloudsmith-test/acme-prod/retention/ \
     --header 'X-Api-Key: test-key' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "retention_enabled": true,
  "retention_days_limit": 180,
  "retention_package_query_string": "tag:~production"
}

What’s Next

We’re actively working on adding support for search-based retention rules to both the Cloudsmith web UI and the Terraform Provider, so you’ll be able to configure them wherever you work.

In the meantime, check out Retention Rules for more information on configuring package retention rules for your Cloudsmith repositories.

Other logs

01/06
New

A simpler way to install the Cloudsmith CLI with Homebrew

Cloudsmith’s CLI is now available as an official Homebrew tap, making installing the Cloudsmith CLI straightforward and quick. For developers already using Homebrew, simply add the tap and install the CLI. Since Homebrew manages dependencies, you don’t need to install or manage Python yourself. Homebrew takes care of it for you. Getting started F…

Jun 13 2025
New

Improved support for Helm Charts with native OCI integration

You can now publish and manage Helm charts in Cloudsmith using modern OCI-based workflows. Charts pushed via Helm V3 to our OCI-compatible registry are correctly identified in the UI and supported through a new dedicated endpoint: helm.oci.cloudsmith.io. These improvements build on our full support for OCI v1.1 compliance and make adopting Helm’s latest distribution model easier…

Jun 12 2025
Improvement

Search now defaults to explicit queries for better results

As organizations use Cloudsmith to manage increasingly large volumes of packages and metadata, the demands on search have changed. To ensure we provide a performant and reliable search experience for all customers, we’ve moved from an implicit to an explicit search model…

May 30 2025
New

Streamlined access to Client Logs via our web app

We've introduced Client Logs into the new web app user interface, delivering a significantly improved experience for gaining visibility into package usage across your Cloudsmith workspace. Previously available in our legacy UI, Client Logs is now more performant, accessible, and interactive. This allows you to visualize, filter, and export information to better understand how your packages are consumed, whether by CI/CD pipelines, IDEs, or external consumers…

May 30 2025
Keep up to date with our monthly product bulletin

By submitting this form, you agree to our privacy policy