# Product Variant Endpoints {#product-variant-endpoints}


Manage product variants (sizes, colors, configurations).


## Base Path {#base-path}


```
/api/product-variant
```


## Endpoints {#endpoints}



### List Variants {#list-variants}


```
GET /api/product-variant
Authorization: Bearer {token}
```


### Create Variant {#create-variant}


```
POST /api/product-variant
Authorization: Bearer {token}
```

```json
{
  "productId": "uuid",
  "options": [
    { "name": "Size", "value": "Large" },
    { "name": "Color", "value": "Blue" }
  ],
  "price": { "unitCost": 29.99, "retailPrice": 49.99 },
  "settings": {
    "isSubscription": false,
    "isPurchaseAutomatically": true,
    "canBeSold": true,
    "canBePurchased": true,
    "canBeRented": false,
    "trackInventory": true
  },
  "quantity": 100
}
```


### Update Variant {#update-variant}


```
PUT /api/product-variant/:id
Authorization: Bearer {token}
```


### Delete Variant {#delete-variant}


```
DELETE /api/product-variant/:id
Authorization: Bearer {token}
```


### Update Variant Price {#update-variant-price}


```
PUT /api/product-variant-price/:id
Authorization: Bearer {token}
```


### Update Variant Settings {#update-variant-settings}


```
PUT /api/product-variant-setting/:id
Authorization: Bearer {token}
```


## Related Pages {#related-pages}


- [Product Endpoints](https://sourcey-gauzy.pages.dev/api/product-endpoints/index.md) — products
- [Product Category Endpoints](https://sourcey-gauzy.pages.dev/api/product-category-endpoints/index.md) — categories
- [Products & Inventory](https://sourcey-gauzy.pages.dev/features/products-and-inventory/index.md) — feature