Queries
product
Fetch a single published product by UID.
productsByStoreUid
List all published products in a store.
Types
Product
| Field | Type | Description |
|---|---|---|
uid | UUID | Product ID |
name | String | Product name |
tagline | String? | Short description |
description | String? | Full description |
contentBlocks | [JSON]? | Structured content blocks |
variants | [ProductVariant] | Product variants |
defaultVariant | ProductVariant | Default variant |
createdAt | DateTime | |
updatedAt | DateTime |
ProductVariant
| Field | Type | Description |
|---|---|---|
uid | UUID | Variant ID |
name | String? | Variant name |
inventoryCount | Int? | Current stock level |
prices | [ProductPrice] | Variant prices |
media | [Media] | Variant images and videos |
deliverables | [ProductDeliverable] | Digital deliverables |
ProductPrice
| Field | Type | Description |
|---|---|---|
uid | UUID | Price ID |
currency | String | ISO currency code |
isDefault | Boolean | Whether this is the default price |
recurringInterval | MONTH | YEAR | null | Billing interval for subscriptions |
trialDuration | String? | Trial period (ONE_DAY, THREE_DAYS, ONE_WEEK, TWO_WEEKS, ONE_MONTH) |
price | LinearProductPriceConfig | VolumeProductPriceConfig | Pricing model |
LinearProductPriceConfig
| Field | Type | Description |
|---|---|---|
priceModel | LINEAR | |
unitPrice | Float | Price per unit in minor currency units (cents) |
VolumeProductPriceConfig
| Field | Type | Description |
|---|---|---|
priceModel | VOLUME | |
tiers | [VolumeTierPrice] | Tiered pricing brackets |
Media
| Field | Type | Description |
|---|---|---|
uid | UUID | Media ID |
type | IMAGE | VIDEO | EXTERNAL_VIDEO | Media type |
url | String? | CDN URL |
alt | String? | Alt text |
ProductDeliverable
| Field | Type | Description |
|---|---|---|
uid | UUID | Deliverable ID |
name | String | Name |
type | DOWNLOAD | CONTENT_UNLOCK | EXTERNAL_LINK | Deliverable type |
description | String? | Description |