Update Variant

Update variant basic information

curl --request PUT \
  --url https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cost": 50000,
  "minimumQuantity": 50000,
  "maximumQuantity": 49999,
  "order": 5000,
  "stock": 1073741823,
  "disableVolumeDiscountOnCoupon": true,
  "randomizeKeyDelivery": true,
  "description": "<string>",
  "customIntervalDays": 123
}
'

import requests

url = "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}"

payload = {
    "name": "<string>",
    "cost": 50000,
    "minimumQuantity": 50000,
    "maximumQuantity": 49999,
    "order": 5000,
    "stock": 1073741823,
    "disableVolumeDiscountOnCoupon": True,
    "randomizeKeyDelivery": True,
    "description": "<string>",
    "customIntervalDays": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    cost: 50000,
    minimumQuantity: 50000,
    maximumQuantity: 49999,
    order: 5000,
    stock: 1073741823,
    disableVolumeDiscountOnCoupon: true,
    randomizeKeyDelivery: true,
    description: '<string>',
    customIntervalDays: 123
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cost' => 50000,
    'minimumQuantity' => 50000,
    'maximumQuantity' => 49999,
    'order' => 5000,
    'stock' => 1073741823,
    'disableVolumeDiscountOnCoupon' => true,
    'randomizeKeyDelivery' => true,
    'description' => '<string>',
    'customIntervalDays' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dateCreated": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cost": 50000,
    "deliveryTypes": [
      "<string>"
    ],
    "files": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "friendlyName": "<string>",
        "ipAddress": "<string>",
        "userId": "<string>"
      }
    ],
    "minimumQuantity": 123,
    "maximumQuantity": 123,
    "order": 123,
    "imageNames": [
      "<string>"
    ],
    "stock": 123,
    "customFields": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "label": "<string>",
        "identifier": "<string>",
        "type": "<string>",
        "isRequired": true,
        "options": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dateCreated": "2023-11-07T05:31:56Z",
            "customFieldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "label": "<string>",
            "value": "<string>",
            "order": 1073741823
          }
        ],
        "placeholder": "<string>",
        "hint": "<string>"
      }
    ],
    "volumeDiscounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "quantity": 1073741824,
        "discountValue": 50000
      }
    ],
    "disableVolumeDiscountOnCoupon": true,
    "randomizeKeyDelivery": true,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "metadata": "<string>",
    "customIntervalDays": 123
  }
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

PUT

stores

{storeId}

products

{productId}

variants

{variantId}

Update variant basic information

curl --request PUT \
  --url https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cost": 50000,
  "minimumQuantity": 50000,
  "maximumQuantity": 49999,
  "order": 5000,
  "stock": 1073741823,
  "disableVolumeDiscountOnCoupon": true,
  "randomizeKeyDelivery": true,
  "description": "<string>",
  "customIntervalDays": 123
}
'

import requests

url = "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}"

payload = {
    "name": "<string>",
    "cost": 50000,
    "minimumQuantity": 50000,
    "maximumQuantity": 49999,
    "order": 5000,
    "stock": 1073741823,
    "disableVolumeDiscountOnCoupon": True,
    "randomizeKeyDelivery": True,
    "description": "<string>",
    "customIntervalDays": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    cost: 50000,
    minimumQuantity: 50000,
    maximumQuantity: 49999,
    order: 5000,
    stock: 1073741823,
    disableVolumeDiscountOnCoupon: true,
    randomizeKeyDelivery: true,
    description: '<string>',
    customIntervalDays: 123
  })
};

fetch('https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cost' => 50000,
    'minimumQuantity' => 50000,
    'maximumQuantity' => 49999,
    'order' => 5000,
    'stock' => 1073741823,
    'disableVolumeDiscountOnCoupon' => true,
    'randomizeKeyDelivery' => true,
    'description' => '<string>',
    'customIntervalDays' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.komerza.com/stores/{storeId}/products/{productId}/variants/{variantId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cost\": 50000,\n  \"minimumQuantity\": 50000,\n  \"maximumQuantity\": 49999,\n  \"order\": 5000,\n  \"stock\": 1073741823,\n  \"disableVolumeDiscountOnCoupon\": true,\n  \"randomizeKeyDelivery\": true,\n  \"description\": \"<string>\",\n  \"customIntervalDays\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dateCreated": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cost": 50000,
    "deliveryTypes": [
      "<string>"
    ],
    "files": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "friendlyName": "<string>",
        "ipAddress": "<string>",
        "userId": "<string>"
      }
    ],
    "minimumQuantity": 123,
    "maximumQuantity": 123,
    "order": 123,
    "imageNames": [
      "<string>"
    ],
    "stock": 123,
    "customFields": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "label": "<string>",
        "identifier": "<string>",
        "type": "<string>",
        "isRequired": true,
        "options": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dateCreated": "2023-11-07T05:31:56Z",
            "customFieldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "label": "<string>",
            "value": "<string>",
            "order": 1073741823
          }
        ],
        "placeholder": "<string>",
        "hint": "<string>"
      }
    ],
    "volumeDiscounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "quantity": 1073741824,
        "discountValue": 50000
      }
    ],
    "disableVolumeDiscountOnCoupon": true,
    "randomizeKeyDelivery": true,
    "description": "<string>",
    "dynamicUrl": "<string>",
    "deliveryMessage": "<string>",
    "metadata": "<string>",
    "customIntervalDays": 123
  }
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

{
  "success": true,
  "message": "<string>",
  "code": "<string>",
  "data": "<unknown>"
}

Authorizations

Authorization

string

header

required

Your API key goes here

Path Parameters

storeId

string<uuid>

required

The store’s unique identifier.

productId

string<uuid>

required

The product’s unique identifier.

variantId

string<uuid>

required

The variant’s unique identifier.

Body

The form containing updated variant fields.

The form used to update a product variant's basic information.

name

string

required

The display name of the variant.

Required string length: 3 - 128

cost

number<double>

required

The cost of the variant (non-negative).

Required range: 0 <= x <= 100000

minimumQuantity

integer<int32>

required

Minimum quantity allowed per order (at least 1).

Required range: 1 <= x <= 100000

maximumQuantity

integer<int32>

required

Maximum quantity allowed per order. Set to -1 for unlimited.

Required range: -1 <= x <= 100000

order

integer<int32>

required

Sort order for display (at least 1).

Required range: 1 <= x <= 10000

type

enum<integer>

required

The type of product that is being sold

Available options:

0,

1

stock

integer<int32>

required

Stock quantity available (non-negative).

Required range: 0 <= x <= 2147483647

stockMode

enum<integer>

required

The stock calculation modes that are used

Available options:

0,

1,

2

disableVolumeDiscountOnCoupon

boolean

required

When true, volume discounts are disabled if a coupon is applied to the order.

randomizeKeyDelivery

boolean

required

When true, license keys are selected randomly from inventory instead of FIFO order.

description

string | null

Optional description shown to customers for this variant.

Maximum string length: 4096

billingInterval

enum<integer>

The billing interval for a subscription product

Available options:

0,

1,

2,

3,

4

customIntervalDays

integer<int32> | null

Custom interval in days when BillingInterval is set to Custom.

Response

The object was successfully updated.

Represents a default generic response for API endpoints.

success

boolean

required

Indicates whether the operation or response was successful.

message

string | null

A descriptive message providing additional context or information about the response.

code

string | null

The error code (if there was an error) to use when referencing the error

data

object

Represents a configurable variant associated with a product, containing various properties such as pricing, stock, delivery options, and custom fields.

Show child attributes

Last modified on August 29, 2025

API Documentation

Reference

OAuth2

User

Stores

Products

Categories

Variants

Coupons

Tickets

Customers

Orders

Reviews

Affiliates

Webhooks

Authorizations

Path Parameters

Body

Response