---
canonical_url: "https://docs.composio.dev/toolkits/cloudsmith"
markdown_url: "https://docs.composio.dev/toolkits/cloudsmith.md"
product: "platform"
version: null
last_updated: null
---

# Cloudsmith

Cloudsmith is a cloud-native artifact management platform for securely managing, distributing, and governing software packages across teams and repositories.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `CLOUDSMITH`
- **Version:** 00000000_00

## Tools

### Get Current User

**Slug:** `CLOUDSMITH_GET_CURRENT_USER`

Return the identity authenticated by the connected Cloudsmith API key. Fails if Cloudsmith reports authenticated=false, even when the HTTP response is 200.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Package

**Slug:** `CLOUDSMITH_GET_PACKAGE`

Get metadata, status, checksums, licensing, and security state for one package in a Cloudsmith repository.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `repo` | string | Yes | Repository slug containing the package. |
| `owner` | string | Yes | Namespace slug that owns the repository. |
| `identifier` | string | Yes | Package identifier accepted by Cloudsmith; prefer identifier_perm returned by SEARCH_PACKAGES. |
| `include_connected_repositories` | boolean | No | Allow lookup in active connected target repositories as well as the requested repository. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Quota

**Slug:** `CLOUDSMITH_GET_QUOTA`

Return current storage and bandwidth usage and allowances for a Cloudsmith namespace without inferring a billing plan name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Namespace slug whose current quota usage should be returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rate Limits

**Slug:** `CLOUDSMITH_GET_RATE_LIMITS`

Return Cloudsmith's current per-resource request limits, remaining counts, intervals, and throttling state for the authenticated principal.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Repository

**Slug:** `CLOUDSMITH_GET_REPOSITORY`

Get configuration, visibility, usage, and capability details for one Cloudsmith repository without returning repository signing keys or certificates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Namespace slug that owns the repository. |
| `identifier` | string | Yes | Repository slug or stable identifier returned by SEARCH_REPOSITORIES. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `CLOUDSMITH_LIST_ORGANIZATIONS`

List Cloudsmith organizations associated with the authenticated principal so an agent can discover namespace slugs for later calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("name" | "-name" | "created_at" | "-created_at" | "slug" | "-slug") | No | Sort organizations by name, created_at, or slug; use a leading - for descending order. |
| `page_size` | integer | No | Organizations to return in this page (1-500; 500 is documented but not live-verified). |
| `next_cursor` | string | No | Continuation cursor returned by a previous call; omit for the first page and pass it back unchanged to continue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Repository Vulnerabilities

**Slug:** `CLOUDSMITH_LIST_REPOSITORY_VULNERABILITIES`

List vulnerability scan summaries for packages in a Cloudsmith repository.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `repo` | string | Yes | Repository slug whose vulnerability scan summaries should be listed. |
| `owner` | string | Yes | Namespace slug that owns the repository. |
| `page_size` | integer | No | Scan summaries to return in this page (1-500; the documented maximum of 500 was not live-verified). |
| `next_cursor` | string | No | Continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Audit Log

**Slug:** `CLOUDSMITH_SEARCH_AUDIT_LOG`

Search paginated audit events for a Cloudsmith namespace by event, actor, or timestamp text.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | Yes | Namespace slug whose audit events should be searched. |
| `query` | string | No | Search term matching audit event names, actors, or timestamps. |
| `page_size` | integer | No | Audit events to return in this page (1-500; 500 is documented but not live-verified). |
| `next_cursor` | string | No | Continuation cursor returned by a previous call; omit for the first page and pass it back unchanged to continue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Packages

**Slug:** `CLOUDSMITH_SEARCH_PACKAGES`

Search packages in a Cloudsmith repository by name, filename, version, distribution, architecture, format, or status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `repo` | string | Yes | Repository slug to search. |
| `sort` | string | No | Comma-separated package sort fields applied in order: name, format, version, status, size, downloads, or date. Prefix any field with - for descending order. |
| `owner` | string | Yes | Namespace slug that owns the repository. |
| `query` | string | No | Search term or Cloudsmith package query matching names, filenames, versions, distributions, architectures, formats, or statuses. |
| `page_size` | integer | No | Packages to return in this page (1-500; the documented maximum of 500 was not live-verified). |
| `next_cursor` | string | No | Continuation cursor returned by a previous call; omit for the first page. |
| `include_connected_repositories` | boolean | No | Also include packages from active connected target repositories. Returned download URLs are rewritten for the requested repository. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Repositories

**Slug:** `CLOUDSMITH_SEARCH_REPOSITORIES`

Search and list repositories within a Cloudsmith namespace, returning identifiers and summary state without repository signing keys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("created_at" | "-created_at" | "downloads" | "-downloads" | "favorites" | "-favorites" | "name" | "-name" | "package_count" | "-package_count" | "size" | "-size") | No | Sort by created_at, downloads, favorites, name, package_count, or size; prefix with - for descending order. |
| `owner` | string | Yes | Namespace slug that owns the repositories, such as an organization slug returned by LIST_ORGANIZATIONS. |
| `query` | string | No | Search repository names or slugs. Cloudsmith also accepts explicit broadcast_state and repository_type filters in this expression. |
| `page_size` | integer | No | Repositories to return in this page (1-500; 500 is documented but not live-verified). |
| `next_cursor` | string | No | Continuation cursor from a previous response's next_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |