●Change8

Migrating to Cloudsmith v1.20.0

Version v1.20.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/30/2026

1
Breaking Changes
1
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

cloudsmith authcloudsmith whoamicloudsmith downloadcloudsmith pushcloudsmith logoutmetadata API clientv2 API Spec loadingdocker commandJWT handlingchecksum handling

Breaking Changes

●Issue #1

The metadata API client has been switched to use the /v2/metadata/ endpoint. If you are programmatically interacting with the metadata API, you may need to update your calls to reflect this change.

Migration Steps

  1. 1
    Update any programmatic calls to the metadata API to use the new `/v2/metadata/` endpoint.

Release Summary

This release introduces significant new features including arbitrary metadata support, enhanced credential management with OIDC auto-discovery and a credential provider chain, and the ability to build and publish standalone CLI binaries. It also includes various bug fixes and dependency upgrades.

Need More Details?

View the full release notes and all changes for Cloudsmith v1.20.0.

View Full Changelog