> ## 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.

# Delist Product

> Queue delist for one product on the marketplaces you name. `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, and ebay. Each named marketplace must already have a listing; other channels are left untouched. Omit `marketplaces` to delist every existing listing. This does not delete the OmniCommerce product. Poll GET /api/v1/jobs/{jobId} until data.status is succeeded, partial, or failed. Accepted means the job was queued, not that the marketplace has removed the listing.



## OpenAPI

````yaml /openapi.json post /api/v1/products/{productId}/delist
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: aops
    description: Agent operating procedures
    x-group: AOPs
  - 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, enrichment, publish, and delist
    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}/delist:
    post:
      tags:
        - products
      summary: Delist Product
      description: >-
        Queue delist for one product on the marketplaces you name.
        `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify,
        whatsapp, zalora, amazon, and ebay. Each named marketplace must already
        have a listing; other channels are left untouched. Omit `marketplaces`
        to delist every existing listing. This does not delete the OmniCommerce
        product. Poll GET /api/v1/jobs/{jobId} until data.status is succeeded,
        partial, or failed. Accepted means the job was queued, not that the
        marketplace has removed the listing.
      operationId: post_v1_products_by_productid_delist
      parameters:
        - name: productId
          in: path
          required: true
          description: >-
            OmniCommerce product or variant ID. A variant delists its parent
            listing.
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                organizationId:
                  type: string
                  description: >-
                    Optional for API-key requests; required for
                    session-authenticated requests across multiple
                    organizations.
                marketplaces:
                  type: array
                  minItems: 1
                  uniqueItems: true
                  description: >-
                    Which marketplaces to delist from. One or more of shopee,
                    lazada, tiktok, shopify, whatsapp, zalora, amazon, ebay.
                    Omit to delist every existing listing.
                  items:
                    type: string
                    enum:
                      - lazada
                      - shopee
                      - tiktok
                      - shopify
                      - whatsapp
                      - zalora
                      - amazon
                      - ebay
            example:
              marketplaces:
                - shopee
                - lazada
      responses:
        '202':
          description: Delist job queued.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  apiVersion:
                    type: string
                    default: developer_v1
                  operationId:
                    type: string
                  status:
                    type: string
                    enum:
                      - accepted
                  productId:
                    type: string
                  jobId:
                    type: string
                    description: >-
                      Pollable delist job. Read it with GET
                      /api/v1/jobs/{jobId}.
                  data:
                    type: object
                    properties:
                      queued:
                        type: boolean
                      delistBatchId:
                        type: string
                      marketplaces:
                        type: array
                        items:
                          type: string
                          enum:
                            - lazada
                            - shopee
                            - tiktok
                            - shopify
                            - whatsapp
                            - zalora
                            - amazon
                            - ebay
                      sourceProductId:
                        type: string
        '400':
          description: >-
            Bad Request - invalid payload, or the product has no listing on a
            requested marketplace
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Product 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.

````