> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace API

> Access syndicated marketplace providers and control which products are visible in your workspace.

## Endpoints

| Method | Path                                               | Description                                                   |
| ------ | -------------------------------------------------- | ------------------------------------------------------------- |
| GET    | `/v1/marketplace/providers`                        | List marketplace providers available to the current workspace |
| GET    | `/v1/marketplace/products`                         | Search marketplace provider products                          |
| GET    | `/v1/marketplace/products/:productId`              | Retrieve full details for a marketplace product               |
| POST   | `/v1/marketplace/products/:productId/enable`       | Enable a marketplace product for your workspace               |
| DELETE | `/v1/marketplace/products/:productId/disable`      | Disable a previously enabled marketplace product              |
| GET    | `/v1/marketplace/products/:productId/availability` | Preview availability projection for a marketplace product     |

<Info>Scopes: `catalog:read` for read endpoints, `catalog:write` for enable/disable, `inventory:read` for availability. All requests must resolve workspace context via API key or session.</Info>

## Sandbox restrictions

<Warning>
  Marketplace APIs are only available in **live workspaces**. Sandbox workspaces cannot access marketplace features.
</Warning>

Attempting to call any marketplace endpoint from a sandbox workspace returns:

```json theme={null}
{
  "error": "Forbidden",
  "message": "Marketplace features is not available in sandbox mode. Please upgrade to a live workspace to access this feature.",
  "code": "SANDBOX_FEATURE_DISABLED"
}
```

To use marketplace features, create a live workspace or convert your sandbox workspace to live.

## Unified products endpoint

Once you enable marketplace products, they appear alongside your owned products in the unified products endpoint:

```bash theme={null}
# Get all products (owned + marketplace)
curl "https://api.voyantcloud.com/v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get only marketplace products
curl "https://api.voyantcloud.com/v1/products?source=marketplace" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get only owned products
curl "https://api.voyantcloud.com/v1/products?source=owned" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Each product in the response includes a `source` field (`owned` or `marketplace`) and marketplace products include `providerId` and `externalProductId` fields.

See [List Products](/api-reference/products/list-products) for full documentation.

## Access model

* Providers are exposed through direct workspace connections or Voyant partner access grants.
* Product toggles control visibility in catalog workflows.
* Availability projections are rolling out provider-by-provider. Unsupported providers return `501 Not Implemented`.