Hey! These docs are for version 1.0, which is no longer officially supported. Click here for the latest version, 1.2!

Identifying a Package

To identify a package, you need to obtain the Unique ID for the package (also called slug_perm for backward compatibility reasons)

You can get this either via the CLI or the Website UI.


Obtaining Unique ID from the Cloudsmith CLI

You can get the Unique ID from the JSON output of the cloudsmith list packages command:

cloudsmith list packages OWNER/REPOSITORY -F pretty_json

The JSON output from this command includes the field slug_perm (Unique ID)

list packages JSON outputlist packages JSON output

list packages JSON output

You can use the -q flag to filter for a format or filename and pipe the output to a tool such as jq to further filter the fields from the JSON output.

Example:

 cloudsmith list packages demo/examples-repo -F pretty_json -q "format:cargo" | jq -r ".data[].filename, .data[].slug_perm"
Using jq to filter JSON outputUsing jq to filter JSON output

Using jq to filter JSON output

The Unique ID for a package is also displayed as part of the output when pushing a package to a repository using the cloudsmith push command:

Unique ID as part of `cloudsmith push` command outputUnique ID as part of `cloudsmith push` command output

Unique ID as part of cloudsmith push command output


Obtaining Unique ID from the Website UI

The Unique ID is also available in the Metadata tab on the package detail page:

Unique ID in Package MetadataUnique ID in Package Metadata

Unique ID in Package Metadata


Did this page help you?