Update Product

Update a product

curl --request PUT \
  --url https://api-eu.flexportal.io/v1/products/{productId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "productSku": "<string>",
  "name": "<string>",
  "specification": "<string>",
  "category": "<string>",
  "brand": "<string>",
  "variants": [
    {
      "variantSku": "<string>",
      "variantName": "<string>",
      "grade": "<string>",
      "pricing": [
        {
          "contractLength": 2,
          "monthlyPrice": 1,
          "setupFee": 1,
          "calculatedAt": "<unknown>",
          "presetUsed": "<string>"
        }
      ],
      "variantId": "<string>",
      "condition": "<string>",
      "colorName": "<string>",
      "images": [
        "<string>"
      ],
      "listPrice": 1,
      "acquisitionCost": 1
    }
  ],
  "description": "<string>",
  "images": [
    "<string>"
  ]
}
'

import requests

url = "https://api-eu.flexportal.io/v1/products/{productId}"

payload = {
    "productSku": "<string>",
    "name": "<string>",
    "specification": "<string>",
    "category": "<string>",
    "brand": "<string>",
    "variants": [
        {
            "variantSku": "<string>",
            "variantName": "<string>",
            "grade": "<string>",
            "pricing": [
                {
                    "contractLength": 2,
                    "monthlyPrice": 1,
                    "setupFee": 1,
                    "calculatedAt": "<unknown>",
                    "presetUsed": "<string>"
                }
            ],
            "variantId": "<string>",
            "condition": "<string>",
            "colorName": "<string>",
            "images": ["<string>"],
            "listPrice": 1,
            "acquisitionCost": 1
        }
    ],
    "description": "<string>",
    "images": ["<string>"]
}
headers = {
    "Tenant-ID": "<tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'Tenant-ID': '<tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    productSku: '<string>',
    name: '<string>',
    specification: '<string>',
    category: '<string>',
    brand: '<string>',
    variants: [
      {
        variantSku: '<string>',
        variantName: '<string>',
        grade: '<string>',
        pricing: [
          {
            contractLength: 2,
            monthlyPrice: 1,
            setupFee: 1,
            calculatedAt: '<unknown>',
            presetUsed: '<string>'
          }
        ],
        variantId: '<string>',
        condition: '<string>',
        colorName: '<string>',
        images: ['<string>'],
        listPrice: 1,
        acquisitionCost: 1
      }
    ],
    description: '<string>',
    images: ['<string>']
  })
};

fetch('https://api-eu.flexportal.io/v1/products/{productId}', 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-eu.flexportal.io/v1/products/{productId}",
  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([
    'productSku' => '<string>',
    'name' => '<string>',
    'specification' => '<string>',
    'category' => '<string>',
    'brand' => '<string>',
    'variants' => [
        [
                'variantSku' => '<string>',
                'variantName' => '<string>',
                'grade' => '<string>',
                'pricing' => [
                                [
                                                                'contractLength' => 2,
                                                                'monthlyPrice' => 1,
                                                                'setupFee' => 1,
                                                                'calculatedAt' => '<unknown>',
                                                                'presetUsed' => '<string>'
                                ]
                ],
                'variantId' => '<string>',
                'condition' => '<string>',
                'colorName' => '<string>',
                'images' => [
                                '<string>'
                ],
                'listPrice' => 1,
                'acquisitionCost' => 1
        ]
    ],
    'description' => '<string>',
    'images' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Tenant-ID: <tenant-id>"
  ],
]);

$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-eu.flexportal.io/v1/products/{productId}"

	payload := strings.NewReader("{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}")

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

	req.Header.Add("Tenant-ID", "<tenant-id>")
	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-eu.flexportal.io/v1/products/{productId}")
  .header("Tenant-ID", "<tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-eu.flexportal.io/v1/products/{productId}")

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

request = Net::HTTP::Put.new(url)
request["Tenant-ID"] = '<tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}"

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

{
  "success": true,
  "message": "<string>",
  "productId": "<string>",
  "productSku": "<string>",
  "operation": "created",
  "variantResults": [
    {
      "variantSku": "<string>",
      "operation": "create"
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

PUT

products

{productId}

Update a product

curl --request PUT \
  --url https://api-eu.flexportal.io/v1/products/{productId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "productSku": "<string>",
  "name": "<string>",
  "specification": "<string>",
  "category": "<string>",
  "brand": "<string>",
  "variants": [
    {
      "variantSku": "<string>",
      "variantName": "<string>",
      "grade": "<string>",
      "pricing": [
        {
          "contractLength": 2,
          "monthlyPrice": 1,
          "setupFee": 1,
          "calculatedAt": "<unknown>",
          "presetUsed": "<string>"
        }
      ],
      "variantId": "<string>",
      "condition": "<string>",
      "colorName": "<string>",
      "images": [
        "<string>"
      ],
      "listPrice": 1,
      "acquisitionCost": 1
    }
  ],
  "description": "<string>",
  "images": [
    "<string>"
  ]
}
'

import requests

url = "https://api-eu.flexportal.io/v1/products/{productId}"

payload = {
    "productSku": "<string>",
    "name": "<string>",
    "specification": "<string>",
    "category": "<string>",
    "brand": "<string>",
    "variants": [
        {
            "variantSku": "<string>",
            "variantName": "<string>",
            "grade": "<string>",
            "pricing": [
                {
                    "contractLength": 2,
                    "monthlyPrice": 1,
                    "setupFee": 1,
                    "calculatedAt": "<unknown>",
                    "presetUsed": "<string>"
                }
            ],
            "variantId": "<string>",
            "condition": "<string>",
            "colorName": "<string>",
            "images": ["<string>"],
            "listPrice": 1,
            "acquisitionCost": 1
        }
    ],
    "description": "<string>",
    "images": ["<string>"]
}
headers = {
    "Tenant-ID": "<tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'Tenant-ID': '<tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    productSku: '<string>',
    name: '<string>',
    specification: '<string>',
    category: '<string>',
    brand: '<string>',
    variants: [
      {
        variantSku: '<string>',
        variantName: '<string>',
        grade: '<string>',
        pricing: [
          {
            contractLength: 2,
            monthlyPrice: 1,
            setupFee: 1,
            calculatedAt: '<unknown>',
            presetUsed: '<string>'
          }
        ],
        variantId: '<string>',
        condition: '<string>',
        colorName: '<string>',
        images: ['<string>'],
        listPrice: 1,
        acquisitionCost: 1
      }
    ],
    description: '<string>',
    images: ['<string>']
  })
};

fetch('https://api-eu.flexportal.io/v1/products/{productId}', 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-eu.flexportal.io/v1/products/{productId}",
  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([
    'productSku' => '<string>',
    'name' => '<string>',
    'specification' => '<string>',
    'category' => '<string>',
    'brand' => '<string>',
    'variants' => [
        [
                'variantSku' => '<string>',
                'variantName' => '<string>',
                'grade' => '<string>',
                'pricing' => [
                                [
                                                                'contractLength' => 2,
                                                                'monthlyPrice' => 1,
                                                                'setupFee' => 1,
                                                                'calculatedAt' => '<unknown>',
                                                                'presetUsed' => '<string>'
                                ]
                ],
                'variantId' => '<string>',
                'condition' => '<string>',
                'colorName' => '<string>',
                'images' => [
                                '<string>'
                ],
                'listPrice' => 1,
                'acquisitionCost' => 1
        ]
    ],
    'description' => '<string>',
    'images' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Tenant-ID: <tenant-id>"
  ],
]);

$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-eu.flexportal.io/v1/products/{productId}"

	payload := strings.NewReader("{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}")

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

	req.Header.Add("Tenant-ID", "<tenant-id>")
	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-eu.flexportal.io/v1/products/{productId}")
  .header("Tenant-ID", "<tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-eu.flexportal.io/v1/products/{productId}")

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

request = Net::HTTP::Put.new(url)
request["Tenant-ID"] = '<tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productSku\": \"<string>\",\n  \"name\": \"<string>\",\n  \"specification\": \"<string>\",\n  \"category\": \"<string>\",\n  \"brand\": \"<string>\",\n  \"variants\": [\n    {\n      \"variantSku\": \"<string>\",\n      \"variantName\": \"<string>\",\n      \"grade\": \"<string>\",\n      \"pricing\": [\n        {\n          \"contractLength\": 2,\n          \"monthlyPrice\": 1,\n          \"setupFee\": 1,\n          \"calculatedAt\": \"<unknown>\",\n          \"presetUsed\": \"<string>\"\n        }\n      ],\n      \"variantId\": \"<string>\",\n      \"condition\": \"<string>\",\n      \"colorName\": \"<string>\",\n      \"images\": [\n        \"<string>\"\n      ],\n      \"listPrice\": 1,\n      \"acquisitionCost\": 1\n    }\n  ],\n  \"description\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ]\n}"

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

{
  "success": true,
  "message": "<string>",
  "productId": "<string>",
  "productSku": "<string>",
  "operation": "created",
  "variantResults": [
    {
      "variantSku": "<string>",
      "operation": "create"
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Overview

Update an existing product’s details and variants. Use this endpoint to modify product information, update pricing, add new variants, or change variant status.

Common Use Cases

Price Updates: Adjust subscription pricing based on market conditions
Add Variants: Add new configurations (colors, specs, grades)
Product Refresh: Update descriptions, images, or categories
Discontinue Variants: Mark old variants as inactive
Grade Adjustments: Reclassify product condition after inspection

Partial Updates

This endpoint supports partial updates. You only need to include fields you want to change:

{
  "name": "MacBook Pro 16\" (2024)",
  "description": "Updated description with new features"
}

Updating Variants

To update variants, include the variants array with the variants you want to modify or add:

{
  "variants": [
    {
      "sku": "MACBOOK-PRO-16-M3-18GB-SILVER",
      "pricing": {
        "12": 149.00,
        "24": 119.00,
        "36": 99.00
      }
    }
  ]
}

Variant Update Behavior

Scenario	Behavior
Existing SKU	Variant is updated with new values
New SKU	New variant is created
Missing SKU	Variant remains unchanged

Variants are matched by sku. If you include a variant with a new SKU, it will be created. To modify an existing variant, you must use its exact current SKU.

Updating Pricing

Update pricing for specific contract lengths:

{
  "variants": [
    {
      "sku": "MACBOOK-PRO-16-M3-18GB-SILVER",
      "pricing": {
        "12": 149.00,
        "24": 119.00
      }
    }
  ]
}

Pricing changes only affect new orders. Existing subscriptions retain their original pricing.

Updating Acquisition Cost

When asset costs change (e.g., new supplier pricing):

{
  "variants": [
    {
      "sku": "MACBOOK-PRO-16-M3-18GB-SILVER",
      "acquisitionCost": 1650.00
    }
  ]
}

This affects cost recovery calculations for new subscriptions.

Discontinuing a Product

To discontinue a product (hide from catalog but preserve history):

{
  "status": "discontinued"
}

Discontinued products cannot be used in new orders but remain visible for existing subscriptions and historical reporting.

Example: Adding New Color Variant

// Add Space Black variant to existing MacBook Pro
await updateProduct('prod_abc123', {
  variants: [
    {
      sku: 'MACBOOK-PRO-16-M3-18GB-BLACK',
      specification: 'M3 Pro, 18GB RAM, 512GB SSD',
      grade: 'A',
      color: 'Space Black',
      listPrice: 2499.00,
      acquisitionCost: 1800.00,
      pricing: {
        '12': 159.00,
        '24': 129.00,
        '36': 109.00
      }
    }
  ]
});

Example: Bulk Price Reduction

// Reduce prices on older stock
await updateProduct('prod_abc123', {
  variants: [
    {
      sku: 'MACBOOK-PRO-16-M3-18GB-SILVER',
      grade: 'B',  // Reclassify as Grade B
      pricing: {
        '12': 139.00,
        '24': 109.00,
        '36': 89.00
      }
    }
  ]
});

Get Product - View current product details
Delete Product - Discontinue a product
List Variants - View all variants

Authorizations

Authorization

string

header

required

API key obtained from FlexPortal dashboard

Headers

Tenant-ID

string

required

Your tenant identifier

Path Parameters

productId

string

required

The product ID

Body

application/json

productSku

string

required

Minimum string length: 1

name

string

required

Minimum string length: 1

specification

string

required

Minimum string length: 1

Response

Product updated

success

enum<boolean>

required

Available options:

true

message

string

required

productId

string

required

productSku

string

required

operation

enum<string>

required

Available options:

created,

updated

variantResults

object[]

required

Show child attributes

Overview

Products

Customers

Orders

Subscriptions

Assets

Payments

Billing Groups

Files

Exports

Overview

Common Use Cases

Partial Updates

Updating Variants

Variant Update Behavior

Updating Pricing

Updating Acquisition Cost

Discontinuing a Product

Example: Adding New Color Variant

Example: Bulk Price Reduction

Authorizations

Headers

Path Parameters

Body

Response

​Overview

​Common Use Cases

​Partial Updates

​Updating Variants

​Variant Update Behavior

​Updating Pricing

​Updating Acquisition Cost

​Discontinuing a Product

​Example: Adding New Color Variant

​Example: Bulk Price Reduction

​Related Endpoints

Authorizations

Headers

Path Parameters

Body

Response

Overview

Common Use Cases

Partial Updates

Updating Variants

Variant Update Behavior

Updating Pricing

Updating Acquisition Cost

Discontinuing a Product

Example: Adding New Color Variant

Example: Bulk Price Reduction

Related Endpoints