Cloudsmith Documentation Hub

Welcome to the Cloudsmith Documentation Hub. You'll find comprehensive guides and documentation to help you start working with Cloudsmith as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

API Bindings

The Cloudsmith API (Application Programmatic Interface) bindings provide libraries in different languages for accessing the service programmatically. The API is fully compliant with the OpenAPI 2.0 Specification and the clients are generated using swagger-codegen-cli from the Swagger Project.

Please note that the generated client APIs are intended for developers, and are subject to change as the upstream API evolves over time (especially pre-1.0 releases). If you're looking for something a little more user-friendly, please see the Cloudsmith CLI application for something that comes pre-baked.


Releases for each language (where supported) are uploaded to the Cloudsmith API repository. Support currently exists for the following languages:





Source Code


Source Code


Source Code

Available on PyPi


Source Code

Available on

If you need a different binding, contact us!

Getting Started

We use swagger-codegen-cli to generate the bindings by using the Cloudsmith API schema that is compliant with the OpenAPI 2.0 Specification.

Each of the supported language bindings has its own directory within the bindings directory, and three standardised scripts are used:

Sets the swagger-codegen configuration for the language and generates the bindings into 'src'.

Runs the test suite for the bindings (minimal) to ensure they are "correct" (able to be compiled).

Uploads the bindings to Cloudsmith and, if appropriate, the language-specific mainline repository.

Adding a new binding involves the creating of a new directory and the implementation of these three scripts to perform the build and release. To see a list of all the available language bindings you can execute:


To receive configuration help (in order to setup correctly), execute:

bin/swagger-codegen-cli config-help -l <language>

Where is the language you're generating bindings for (e.g. python).


The version of the generated library bindings is automatically made to match the upstream API. So if the Cloudsmith API is currently 0.21.5, then the language bindings will also be 0.21.5.


The client APIs are automatically released as part of the build and release process. See the CI configuration in the Source Code for more details.

Updated about a month ago

API Bindings

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.

Cloudsmith is the new standard in Package Management and Software Distribution

With support for all major package formats, you can trust us to manage your software supply chain.

Start My Free Trial Now
Cookie Declaration (Manage Cookies)