> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json patch /api/v1/products/{productId}/price openapi: 3.1.0 info: title: OmniCommerce API version: 1.0.0 license: name: Proprietary url: https://omnicommerce.sg/terms description: >- OmniCommerce API surface for agents and developer integrations. Includes public endpoints (merchant discovery, product search, compare, catalog, ACO retrieval) and authenticated endpoints (product management via API key Bearer tokens). servers: - url: https://omnicommerce.sg description: Production - url: http://localhost:3000 description: Local development security: [] tags: - name: agentic-checkout description: Merchant-fulfilled agentic checkout x-group: Agentic Checkout - name: commerce description: Root commerce discovery x-group: Commerce - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: looks description: AI-styled product looks x-group: Looks - name: oauth description: OAuth token endpoints x-group: OAuth - name: orders description: Workspace and agentic orders x-group: Orders - name: organizations description: Organization management x-group: Organizations - name: price-books description: Marketplace list-price markup rules x-group: Price Books - name: products description: Product CRUD, bulk import, and publish x-group: Products - name: promotions description: Central promotions and marketplace sync x-group: Promotions - name: public-agent description: Public agent discovery and catalog APIs x-group: Public Agent - name: returns description: returns x-group: Returns - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/products/{productId}/price: patch: tags: - products summary: Update Product Price description: >- 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. operationId: patch_v1_products_by_productid_price parameters: - name: productId in: path required: true description: OmniCommerce simple-product or variant UUID. schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false anyOf: - required: - price - required: - salePrice properties: price: type: number minimum: 0 description: New catalog list price. Provide price or salePrice. salePrice: type: - number - 'null' minimum: 0 description: >- Optional sale price. Use null to clear it; it must be below the list price. currency: type: string pattern: ^[A-Za-z]{3}$ description: Three-letter ISO currency code. syncToMarketplaces: type: boolean default: false description: Queue durable sync jobs after the Omni catalog update. targets: type: array minItems: 1 maxItems: 25 description: >- Exact enabled and published marketplace accounts. Requires syncToMarketplaces=true. items: type: object additionalProperties: false required: - platform - accountId properties: platform: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon accountId: type: string maxLength: 255 example: price: 29.9 currency: SGD syncToMarketplaces: true targets: - platform: lazada accountId: seller-123 responses: '200': description: Catalog price updated; no marketplace job was queued. content: application/json: schema: type: object additionalProperties: false required: - apiVersion - ok - operationId - status - productId - warnings - recommendations - links - data properties: apiVersion: type: string enum: - developer_v1 ok: type: boolean enum: - true operationId: type: string format: uuid status: type: string enum: - completed - accepted productId: type: string format: uuid jobId: type: string format: uuid warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object additionalProperties: type: string data: type: object additionalProperties: false required: - changed - changedFields - price - salePrice - currency - syncToMarketplaces - jobIds - targets - emittedEvents properties: changed: type: boolean changedFields: type: array items: type: string price: type: - number - 'null' salePrice: type: - number - 'null' currency: type: - string - 'null' syncToMarketplaces: type: boolean jobIds: type: array items: type: string format: uuid targets: type: array items: type: object additionalProperties: false required: - platform - accountId - status - jobId properties: platform: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon accountId: type: string description: >- Exact marketplace store, shop, or seller account ID. status: type: string enum: - queued jobId: type: string format: uuid targetId: type: string description: Target correlation within a price-sync batch. emittedEvents: type: array items: type: string enum: - product.price.changed '202': description: Catalog price updated and marketplace sync queued. content: application/json: schema: type: object additionalProperties: false required: - apiVersion - ok - operationId - status - productId - warnings - recommendations - links - data properties: apiVersion: type: string enum: - developer_v1 ok: type: boolean enum: - true operationId: type: string format: uuid status: type: string enum: - completed - accepted productId: type: string format: uuid jobId: type: string format: uuid warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object additionalProperties: type: string data: type: object additionalProperties: false required: - changed - changedFields - price - salePrice - currency - syncToMarketplaces - jobIds - targets - emittedEvents properties: changed: type: boolean changedFields: type: array items: type: string price: type: - number - 'null' salePrice: type: - number - 'null' currency: type: - string - 'null' syncToMarketplaces: type: boolean jobIds: type: array items: type: string format: uuid targets: type: array items: type: object additionalProperties: false required: - platform - accountId - status - jobId properties: platform: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon accountId: type: string description: >- Exact marketplace store, shop, or seller account ID. status: type: string enum: - queued jobId: type: string format: uuid targetId: type: string description: Target correlation within a price-sync batch. emittedEvents: type: array items: type: string enum: - product.price.changed '400': description: Invalid price, variant selection, or marketplace target. '401': description: Unauthorized '403': description: Credential lacks catalog:write or organization is inactive. '404': description: Product or variant not found. '500': description: Internal Server Error security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows. ````