Update Product Price

curl --request PATCH \
  --url https://omnicommerce.sg/api/v1/products/{productId}/price \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "price": 29.9
}'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({price: 29.9})
};

fetch('https://omnicommerce.sg/api/v1/products/{productId}/price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://omnicommerce.sg/api/v1/products/{productId}/price"

payload = { "price": 29.9 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "apiVersion": "developer_v1",
  "ok": true,
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "completed",
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "changed": true,
    "changedFields": [
      "<string>"
    ],
    "price": 123,
    "salePrice": 123,
    "currency": "<string>",
    "syncToMarketplaces": true,
    "jobIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "targets": [
      {
        "platform": "shopee",
        "accountId": "<string>",
        "status": "queued",
        "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "targetId": "<string>"
      }
    ],
    "emittedEvents": [
      "product.price.changed"
    ]
  },
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "apiVersion": "developer_v1",
  "ok": true,
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "completed",
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "changed": true,
    "changedFields": [
      "<string>"
    ],
    "price": 123,
    "salePrice": 123,
    "currency": "<string>",
    "syncToMarketplaces": true,
    "jobIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "targets": [
      {
        "platform": "shopee",
        "accountId": "<string>",
        "status": "queued",
        "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "targetId": "<string>"
      }
    ],
    "emittedEvents": [
      "product.price.changed"
    ]
  },
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Products

Update Product Price

Update the canonical catalog price for a simple product or variant UUID. Multi-variant parent products must be updated through their variant IDs. A successful change emits product.price.changed to matching developer webhook subscriptions.

Authorization

Requires an API credential with catalog:write. OmniCommerce derives organizationId from that credential; the request body cannot select or override an organization.

Marketplace sync

The update is Omni-only by default. Set syncToMarketplaces to true to queue durable marketplace work. Omit targets to sync every enabled, published account for the product, or provide exact { platform, accountId } targets. Every explicit target is validated before the catalog changes. The response contains pollable job IDs and immediate per-target queue status; use GET /api/v1/jobs/{jobId} for progress.

PATCH

api

products

{productId}

price

Update Product Price

curl --request PATCH \
  --url https://omnicommerce.sg/api/v1/products/{productId}/price \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "price": 29.9
}'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({price: 29.9})
};

fetch('https://omnicommerce.sg/api/v1/products/{productId}/price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://omnicommerce.sg/api/v1/products/{productId}/price"

payload = { "price": 29.9 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "apiVersion": "developer_v1",
  "ok": true,
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "completed",
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "changed": true,
    "changedFields": [
      "<string>"
    ],
    "price": 123,
    "salePrice": 123,
    "currency": "<string>",
    "syncToMarketplaces": true,
    "jobIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "targets": [
      {
        "platform": "shopee",
        "accountId": "<string>",
        "status": "queued",
        "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "targetId": "<string>"
      }
    ],
    "emittedEvents": [
      "product.price.changed"
    ]
  },
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "apiVersion": "developer_v1",
  "ok": true,
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "completed",
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "changed": true,
    "changedFields": [
      "<string>"
    ],
    "price": 123,
    "salePrice": 123,
    "currency": "<string>",
    "syncToMarketplaces": true,
    "jobIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "targets": [
      {
        "platform": "shopee",
        "accountId": "<string>",
        "status": "queued",
        "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "targetId": "<string>"
      }
    ],
    "emittedEvents": [
      "product.price.changed"
    ]
  },
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization

string

header

required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Path Parameters

productId

string<uuid>

required

OmniCommerce simple-product or variant UUID.

Body

application/json

Option 1
Option 2

price

number

required

New catalog list price. Provide price or salePrice.

Required range: x >= 0

salePrice

number | null

Optional sale price. Use null to clear it; it must be below the list price.

Required range: x >= 0

currency

string

Three-letter ISO currency code.

Pattern: ^[A-Za-z]{3}$

syncToMarketplaces

boolean

default:false

Queue durable sync jobs after the Omni catalog update.

targets

object[]

Exact enabled and published marketplace accounts. Requires syncToMarketplaces=true.

Required array length: 1 - 25 elements

Show child attributes

Response

Catalog price updated; no marketplace job was queued.

apiVersion

enum<string>

required

Available options:

developer_v1

enum<boolean>

required

Available options:

true

operationId

string<uuid>

required

status

enum<string>

required

Available options:

completed,

accepted

productId

string<uuid>

required

warnings

string[]

required

recommendations

string[]

required

links

object

required

Show child attributes

data

object

required

Show child attributes

jobId

string<uuid>

Overview

Endpoints

Webhooks

Update Product Price

Authorization

Marketplace sync

Authorizations

Path Parameters

Body

Response