Skip to content

Product ​

INFO

Every response arrives in the shared envelope — code, message, messages, status_code, time — with the payload in data. The tables below describe what is inside data.

POST /product/create ​

This method allows adding product into the account.

Request body

FieldTypeRequiredDescription
namestringYes
notestringNo
measure_idstringYesid of measure unit
category_idstringNoid of product categories
box_type_idstringNoid of Box type
box_itemnumberNonumber of items that exist in one box. Default: 0
box_item_barcodestringNoid of box item's barcode
skustringYeslocal unique id of product
barcodestringNobarcode of product
supplier_idsstring[]Nolist of supplier ids
warehouse_numberstringNoProduct's location in the warehouse (aisle/shelf/bin label). Optional, free-form.
imagestringNoimage path of product that uploaded to the server
is_compoundbooleanNois compound product or not. Default: false
materialsobject[]Nolist of materials of product. required if is_compound is true
materials[].material_idstringYes
materials[].amountnumberYes
materials[].box_countintegerNo
barcodesobject[]Nolist of barcodes of product
barcodes[].is_activebooleanNo
barcodes[].barcodestringNo
is_semi_productbooleanYesis semi product or not. Default: false
is_productbooleanYesis product or not. Default: false
is_materialbooleanYesis material or not. Default: false
is_markedbooleanYesis marked or not. Default: false
dimensionobjectNodimension of product
dimension.shapestringNoOne of: circular, rectangular, other
dimension.netto_weightnumberNo
dimension.gross_weightnumberNo
dimension.heightnumberNo
dimension.volumenumberNo
dimension.diameternumberNo
dimension.widthnumberNo
dimension.lengthnumberNo
is_variantbooleanNois variant or not. Default: false
variantsobject[]No
variants[].skustringYes
variants[].barcodestringNo
variants[].imagebooleanNo
variants[].organizationsobject[]Yes
variants[].organizations[].organization_idstringYes
variants[].organizations[].is_availablebooleanYes
variants[].organizations[].max_stocknumberNo
variants[].organizations[].yellow_linenumberNo
variants[].organizations[].red_linenumberNo
variants[].organizations[].standardnumberNo
variants[].organizations[].is_available_for_salebooleanNo
variants[].attributesobject[]Yes
variants[].attributes[].attribute_idstringYes
variants[].attributes[].attribute_item_idstringYes
organizationsobject[]Yes
organizations[].organization_idstringYes
organizations[].is_availablebooleanYes
organizations[].max_stocknumberNo
organizations[].yellow_linenumberNo
organizations[].red_linenumberNo
organizations[].standardnumberNo
organizations[].is_available_for_salebooleanNo
organizations[].pricesobject[]Nolist of prices with optional UOM prices
organizations[].prices[].price_idstringYes
organizations[].prices[].amountnumberNo
organizations[].prices[].uom_pricesobject[]No
json
{
  "name": "string",
  "note": "string",
  "measure_id": "67b486d242ed76693cd2cc59",
  "category_id": "67b486d242ed76693cd2cc59",
  "box_type_id": "67b486d242ed76693cd2cc59",
  "box_item": 0,
  "box_item_barcode": "string",
  "sku": "string",
  "barcode": "string",
  "supplier_ids": [
    "string"
  ],
  "warehouse_number": "string",
  "image": "string",
  "is_compound": false,
  "materials": [
    {
      "material_id": "67b486d242ed76693cd2cc59",
      "amount": 0,
      "box_count": 0
    }
  ],
  "barcodes": [
    {
      "is_active": false,
      "barcode": "string"
    }
  ],
  "is_semi_product": false,
  "is_product": false,
  "is_material": false,
  "is_marked": false,
  "dimension": {
    "shape": "circular",
    "netto_weight": 0,
    "gross_weight": 0,
    "height": 0,
    "volume": 0,
    "diameter": 0,
    "width": 0,
    "length": 0
  },
  "is_variant": false,
  "variants": [
    {
      "sku": "string",
      "barcode": "string",
      "image": false,
      "organizations": [],
      "attributes": []
    }
  ],
  "organizations": [
    {
      "organization_id": "67b486d242ed76693cd2cc59",
      "is_available": false,
      "max_stock": 0,
      "yellow_line": 0,
      "red_line": 0,
      "standard": 0,
      "is_available_for_sale": false,
      "prices": []
    }
  ]
}

Response

FieldTypeDescription
_idstringid of product
created_atstring
updated_atstring
namestring
numberstring
notestring
box_itemnumber
box_item_barcodestring
box_type_idstring
box_typeobject
box_type._idstring
box_type.codestring
box_type.short_namestring
box_type.namestring
measureobject
measure._idstring
measure.system_codestring
measure.codestring
measure.short_namestring
measure.namestring
measure.decimal_countnumber
skustring
barcodestring
barcodesobject[]list of barcodes of product
barcodes[].is_activeboolean
barcodes[].barcodestring
supplier_idsstring[]list of supplier ids
warehouse_numberstringProduct's location in the warehouse (aisle/shelf/bin label). Absent when not set.
imagestringimage path of product that uploaded to the server
materialsobject[]list of materials of product. required if is_compound is true
materials[].material_idstring
materials[].amountnumber
materials[].box_countinteger
materials[].materialobject
materials[].material._idstring
materials[].material.namestring
materials[].material.skustring
is_compoundbooleanis compound product or not
is_markedbooleanis marked or not
is_productbooleanis product or not. Default: false
is_materialbooleanis material or not. Default: false
is_semi_productbooleanis semi product or not. Default: false
dimensionobjectdimension of product
dimension.shapestringOne of: circular, rectangular, other
dimension.netto_weightnumber
dimension.gross_weightnumber
dimension.heightnumber
dimension.volumenumber
dimension.diameternumber
dimension.widthnumber
dimension.lengthnumber
is_variantbooleanis variant or not
is_parentbooleanis parent or not
attributesobject[]
attributes[].attribute_idstring
attributes[].attribute_item_idstring
parent_idstringid of parent product. it depends on variant product
organizationsobject[]
organizations[].organization_idstring
organizations[].is_availableboolean
organizations[].max_stocknumber
organizations[].yellow_linenumber
organizations[].red_linenumber
organizations[].standardnumber
organizations[].is_available_for_saleboolean
organizations[].pricesobject[]list of prices with optional UOM prices
organizations[].prices[].price_idstring
organizations[].prices[].amountnumber
organizations[].prices[].uom_pricesobject[]
tax_idsstring[]list of tax ids
discount_idsstring[]list of discount ids
categoryobject
category._idstring
category.namestring
custom_fieldsobject[]
custom_fields[]._idstring
custom_fields[].valuestring
json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "_id": "67b486d242ed76693cd2cc59",
    "created_at": "2023-10-01T12:00:00Z",
    "updated_at": "2023-10-01T12:00:00Z",
    "name": "string",
    "number": "string",
    "note": "string",
    "box_item": 0,
    "box_item_barcode": "string",
    "box_type_id": "67b486d242ed76693cd2cc59",
    "box_type": {
      "_id": "67b486d242ed76693cd2cc59",
      "code": "string",
      "short_name": "string",
      "name": "string"
    },
    "measure": {
      "_id": "67b486d242ed76693cd2cc59",
      "system_code": "string",
      "code": "string",
      "short_name": "string",
      "name": "string",
      "decimal_count": 0
    },
    "sku": "string",
    "barcode": "string",
    "barcodes": [
      {
        "is_active": false,
        "barcode": "string"
      }
    ],
    "supplier_ids": [
      "string"
    ],
    "warehouse_number": "string",
    "image": "string",
    "materials": [
      {
        "material_id": "67b486d242ed76693cd2cc59",
        "amount": 0,
        "box_count": 0,
        "material": {
          "_id": null,
          "name": null,
          "sku": null
        }
      }
    ],
    "is_compound": false,
    "is_marked": false,
    "is_product": false,
    "is_material": false,
    "is_semi_product": false,
    "dimension": {
      "shape": "circular",
      "netto_weight": 0,
      "gross_weight": 0,
      "height": 0,
      "volume": 0,
      "diameter": 0,
      "width": 0,
      "length": 0
    },
    "is_variant": false,
    "is_parent": false,
    "attributes": [
      {
        "attribute_id": "string",
        "attribute_item_id": "string"
      }
    ],
    "parent_id": "67b486d242ed76693cd2cc59",
    "organizations": [
      {
        "organization_id": "67b486d242ed76693cd2cc59",
        "is_available": false,
        "max_stock": 0,
        "yellow_line": 0,
        "red_line": 0,
        "standard": 0,
        "is_available_for_sale": false,
        "prices": []
      }
    ],
    "tax_ids": [
      "string"
    ],
    "discount_ids": [
      "string"
    ],
    "category": {
      "_id": "67b486d242ed76693cd2cc59",
      "name": "string"
    },
    "custom_fields": [
      {
        "_id": "67b486d242ed76693cd2cc59",
        "value": "string"
      }
    ]
  },
  "time": "2025-05-01T12:00:00Z"
}

PUT /product/update ​

This method allows updating product in the account.

Request body

FieldTypeRequiredDescription
_idstringNoid of product
namestringYes
measure_idstringYesid of measure unit
category_idstringNoid of product categories
box_type_idstringNoid of Box type
box_itemnumberYesnumber of items that exist in one box. Default: 0
box_item_barcodestringNoid of box item's barcode
skustringYeslocal unique id of product
barcodestringNobarcode of product
supplier_idsstring[]Nolist of supplier ids
warehouse_numberstringNoProduct's location in the warehouse (aisle/shelf/bin label). Optional, free-form.
imagestringNoimage path of product that uploaded to the server
materialsobject[]Nolist of materials of product. required if is_compound is true
materials[].material_idstringYes
materials[].amountnumberYes
materials[].box_countintegerNo
barcodesobject[]Nolist of barcodes of product
barcodes[].is_activebooleanNo
barcodes[].barcodestringNo
is_semi_productbooleanYesis semi product or not. Default: false
is_productbooleanYesis product or not. Default: false
is_materialbooleanYesis material or not. Default: false
dimensionobjectNodimension of product
dimension.shapestringNoOne of: circular, rectangular, other
dimension.netto_weightnumberNo
dimension.gross_weightnumberNo
dimension.heightnumberNo
dimension.volumenumberNo
dimension.diameternumberNo
dimension.widthnumberNo
dimension.lengthnumberNo
variantsobject[]Nolist of variants of product. required if is_variant is true
variants[]._idstringYes
variants[].skustringYes
variants[].barcodestringNo
variants[].imagebooleanNo
variants[].organizationsobject[]Yes
variants[].organizations[].organization_idstringYes
variants[].organizations[].is_availablebooleanYes
variants[].organizations[].max_stocknumberNo
variants[].organizations[].yellow_linenumberNo
variants[].organizations[].red_linenumberNo
variants[].organizations[].standardnumberNo
variants[].organizations[].is_available_for_salebooleanNo
variants[].attributesobject[]Yes
variants[].attributes[].attribute_idstringYes
variants[].attributes[].attribute_item_idstringYes
organizationsobject[]Yes
organizations[].organization_idstringYes
organizations[].is_availablebooleanYes
organizations[].max_stocknumberNo
organizations[].yellow_linenumberNo
organizations[].red_linenumberNo
organizations[].standardnumberNo
organizations[].is_available_for_salebooleanNo
organizations[].pricesobject[]Nolist of prices with optional UOM prices
organizations[].prices[].price_idstringYes
organizations[].prices[].amountnumberNo
organizations[].prices[].uom_pricesobject[]No
json
{
  "_id": "string",
  "name": "string",
  "measure_id": "string",
  "category_id": "string",
  "box_type_id": "string",
  "box_item": 0,
  "box_item_barcode": "string",
  "sku": "string",
  "barcode": "string",
  "supplier_ids": [
    "string"
  ],
  "warehouse_number": "string",
  "image": "string",
  "materials": [
    {
      "material_id": "string",
      "amount": 0,
      "box_count": 0
    }
  ],
  "barcodes": [
    {
      "is_active": false,
      "barcode": "string"
    }
  ],
  "is_semi_product": false,
  "is_product": false,
  "is_material": false,
  "dimension": {
    "shape": "circular",
    "netto_weight": 0,
    "gross_weight": 0,
    "height": 0,
    "volume": 0,
    "diameter": 0,
    "width": 0,
    "length": 0
  },
  "variants": [
    {
      "_id": "string",
      "sku": "string",
      "barcode": "string",
      "image": false,
      "organizations": [],
      "attributes": []
    }
  ],
  "organizations": [
    {
      "organization_id": "string",
      "is_available": false,
      "max_stock": 0,
      "yellow_line": 0,
      "red_line": 0,
      "standard": 0,
      "is_available_for_sale": false,
      "prices": []
    }
  ]
}

Response

Same response shape as POST /product/create.

DELETE /product/delete/{id} ​

Delete a product

Path parameters

ParameterTypeRequiredDescription
idstringYes

Request body

No request body.

Response

json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": "ok",
  "time": "2025-05-01T12:00:00Z"
}

GET /product/get-by-id/{id} ​

Get product using its _id

Path parameters

ParameterTypeRequiredDescription
idstringYes

Request body

No request body.

Response

Same response shape as POST /product/create.

POST /product/get-paging ​

Get products by paging

Request body

FieldTypeRequiredDescription
pagenumberYesDefault: 1
limitnumberYesDefault: 20
organization_idstringNo
is_mainbooleanNo
category_idstringNo
is_archivedbooleanNo
is_compoundbooleanNo
is_semi_productbooleanNo
is_productbooleanNo
is_materialbooleanNo
updated_atstringNoISO time format
is_available_for_salebooleanNo
json
{
  "page": 1,
  "limit": 20,
  "organization_id": "string",
  "is_main": false,
  "category_id": "string",
  "is_archived": false,
  "is_compound": false,
  "is_semi_product": false,
  "is_product": false,
  "is_material": false,
  "updated_at": "string",
  "is_available_for_sale": false
}

Response

data.total is the total number of records and data.data[] holds the current page. The table below describes one record.

FieldTypeDescription
_idstringid of product
created_atstring
updated_atstring
namestring
numberstring
notestring
box_itemnumber
box_item_barcodestring
box_type_idstring
box_typeobject
box_type._idstring
box_type.codestring
box_type.short_namestring
box_type.namestring
measureobject
measure._idstring
measure.system_codestring
measure.codestring
measure.short_namestring
measure.namestring
measure.decimal_countnumber
skustring
barcodestring
barcodesobject[]list of barcodes of product
barcodes[].is_activeboolean
barcodes[].barcodestring
supplier_idsstring[]list of supplier ids
warehouse_numberstringProduct's location in the warehouse (aisle/shelf/bin label). Absent when not set.
imagestringimage path of product that uploaded to the server
materialsobject[]list of materials of product. required if is_compound is true
materials[].material_idstring
materials[].amountnumber
materials[].box_countinteger
materials[].materialobject
materials[].material._idstring
materials[].material.namestring
materials[].material.skustring
is_compoundbooleanis compound product or not
is_markedbooleanis marked or not
is_productbooleanis product or not. Default: false
is_materialbooleanis material or not. Default: false
is_semi_productbooleanis semi product or not. Default: false
dimensionobjectdimension of product
dimension.shapestringOne of: circular, rectangular, other
dimension.netto_weightnumber
dimension.gross_weightnumber
dimension.heightnumber
dimension.volumenumber
dimension.diameternumber
dimension.widthnumber
dimension.lengthnumber
is_variantbooleanis variant or not
is_parentbooleanis parent or not
attributesobject[]
attributes[].attribute_idstring
attributes[].attribute_item_idstring
parent_idstringid of parent product. it depends on variant product
organizationsobject[]
organizations[].organization_idstring
organizations[].is_availableboolean
organizations[].max_stocknumber
organizations[].yellow_linenumber
organizations[].red_linenumber
organizations[].standardnumber
organizations[].is_available_for_saleboolean
organizations[].pricesobject[]list of prices with optional UOM prices
organizations[].prices[].price_idstring
organizations[].prices[].amountnumber
organizations[].prices[].uom_pricesobject[]
tax_idsstring[]list of tax ids
discount_idsstring[]list of discount ids
categoryobject
category._idstring
category.namestring
custom_fieldsobject[]
custom_fields[]._idstring
custom_fields[].valuestring
json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "total": 0,
    "data": [
      {
        "_id": "67b486d242ed76693cd2cc59",
        "created_at": "2023-10-01T12:00:00Z",
        "updated_at": "2023-10-01T12:00:00Z",
        "name": "string",
        "number": "string",
        "note": "string",
        "box_item": 0,
        "box_item_barcode": "string",
        "box_type_id": "67b486d242ed76693cd2cc59",
        "box_type": {
          "_id": "67b486d242ed76693cd2cc59",
          "code": "string",
          "short_name": "string",
          "name": "string"
        },
        "measure": {
          "_id": "67b486d242ed76693cd2cc59",
          "system_code": "string",
          "code": "string",
          "short_name": "string",
          "name": "string",
          "decimal_count": 0
        },
        "sku": "string",
        "barcode": "string",
        "barcodes": [
          {
            "is_active": false,
            "barcode": "string"
          }
        ],
        "supplier_ids": [
          "string"
        ],
        "warehouse_number": "string",
        "image": "string",
        "materials": [
          {
            "material_id": "67b486d242ed76693cd2cc59",
            "amount": 0,
            "box_count": 0,
            "material": {
              "_id": null,
              "name": null,
              "sku": null
            }
          }
        ],
        "is_compound": false,
        "is_marked": false,
        "is_product": false,
        "is_material": false,
        "is_semi_product": false,
        "dimension": {
          "shape": "circular",
          "netto_weight": 0,
          "gross_weight": 0,
          "height": 0,
          "volume": 0,
          "diameter": 0,
          "width": 0,
          "length": 0
        },
        "is_variant": false,
        "is_parent": false,
        "attributes": [
          {
            "attribute_id": "string",
            "attribute_item_id": "string"
          }
        ],
        "parent_id": "67b486d242ed76693cd2cc59",
        "organizations": [
          {
            "organization_id": "67b486d242ed76693cd2cc59",
            "is_available": false,
            "max_stock": 0,
            "yellow_line": 0,
            "red_line": 0,
            "standard": 0,
            "is_available_for_sale": false,
            "prices": []
          }
        ],
        "tax_ids": [
          "string"
        ],
        "discount_ids": [
          "string"
        ],
        "category": {
          "_id": "67b486d242ed76693cd2cc59",
          "name": "string"
        },
        "custom_fields": [
          {
            "_id": "67b486d242ed76693cd2cc59",
            "value": "string"
          }
        ]
      }
    ]
  },
  "time": "2025-05-01T12:00:00Z"
}

GET /product/get-deleted ​

Get deleted product ids

Query parameters

ParameterTypeRequiredDescription
deleted_atstringYes

Request body

No request body.

Response

json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": [
    "string"
  ],
  "time": "2025-05-01T12:00:00Z"
}

POST /product/get-paging/by-price ​

Paginated list of products with prices for a specific price list.

Request body

FieldTypeRequiredDescription
pagenumberYesDefault: 1
limitnumberYesDefault: 20
price_idstringYesPrice list to fetch prices from.
searchstringNo
category_idsstring[]No
json
{
  "page": 1,
  "limit": 20,
  "price_id": "string",
  "search": "string",
  "category_ids": [
    "string"
  ]
}

Response

FieldTypeDescription
listobject[]
list[]._idstringid of product
list[].created_atstring
list[].updated_atstring
list[].namestring
list[].numberstring
list[].notestring
list[].box_itemnumber
list[].box_item_barcodestring
list[].box_type_idstring
list[].box_typeobject
list[].box_type._idstring
list[].box_type.codestring
list[].box_type.short_namestring
list[].box_type.namestring
list[].measureobject
list[].measure._idstring
list[].measure.system_codestring
list[].measure.codestring
list[].measure.short_namestring
list[].measure.namestring
list[].measure.decimal_countnumber
list[].skustring
list[].barcodestring
list[].barcodesobject[]list of barcodes of product
list[].barcodes[].is_activeboolean
list[].barcodes[].barcodestring
list[].supplier_idsstring[]list of supplier ids
list[].warehouse_numberstringProduct's location in the warehouse (aisle/shelf/bin label). Absent when not set.
list[].imagestringimage path of product that uploaded to the server
list[].materialsobject[]list of materials of product. required if is_compound is true
list[].materials[].material_idstring
list[].materials[].amountnumber
list[].materials[].box_countinteger
list[].materials[].materialobject
list[].is_compoundbooleanis compound product or not
list[].is_markedbooleanis marked or not
list[].is_productbooleanis product or not. Default: false
list[].is_materialbooleanis material or not. Default: false
list[].is_semi_productbooleanis semi product or not. Default: false
list[].dimensionobjectdimension of product
list[].dimension.shapestringOne of: circular, rectangular, other
list[].dimension.netto_weightnumber
list[].dimension.gross_weightnumber
list[].dimension.heightnumber
list[].dimension.volumenumber
list[].dimension.diameternumber
list[].dimension.widthnumber
list[].dimension.lengthnumber
list[].is_variantbooleanis variant or not
list[].is_parentbooleanis parent or not
list[].attributesobject[]
list[].attributes[].attribute_idstring
list[].attributes[].attribute_item_idstring
list[].parent_idstringid of parent product. it depends on variant product
list[].organizationsobject[]
list[].organizations[].organization_idstring
list[].organizations[].is_availableboolean
list[].organizations[].max_stocknumber
list[].organizations[].yellow_linenumber
list[].organizations[].red_linenumber
list[].organizations[].standardnumber
list[].organizations[].is_available_for_saleboolean
list[].organizations[].pricesobject[]list of prices with optional UOM prices
list[].tax_idsstring[]list of tax ids
list[].discount_idsstring[]list of discount ids
list[].categoryobject
list[].category._idstring
list[].category.namestring
list[].custom_fieldsobject[]
list[].custom_fields[]._idstring
list[].custom_fields[].valuestring
totalnumber
json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "list": [
      {
        "_id": "67b486d242ed76693cd2cc59",
        "created_at": "2023-10-01T12:00:00Z",
        "updated_at": "2023-10-01T12:00:00Z",
        "name": "string",
        "number": "string",
        "note": "string",
        "box_item": 0,
        "box_item_barcode": "string",
        "box_type_id": "67b486d242ed76693cd2cc59",
        "box_type": {
          "_id": null,
          "code": null,
          "short_name": null,
          "name": null
        },
        "measure": {
          "_id": null,
          "system_code": null,
          "code": null,
          "short_name": null,
          "name": null,
          "decimal_count": null
        },
        "sku": "string",
        "barcode": "string",
        "barcodes": [],
        "supplier_ids": [],
        "warehouse_number": "string",
        "image": "string",
        "materials": [],
        "is_compound": false,
        "is_marked": false,
        "is_product": false,
        "is_material": false,
        "is_semi_product": false,
        "dimension": {
          "shape": null,
          "netto_weight": null,
          "gross_weight": null,
          "height": null,
          "volume": null,
          "diameter": null,
          "width": null,
          "length": null
        },
        "is_variant": false,
        "is_parent": false,
        "attributes": [],
        "parent_id": "67b486d242ed76693cd2cc59",
        "organizations": [],
        "tax_ids": [],
        "discount_ids": [],
        "category": {
          "_id": null,
          "name": null
        },
        "custom_fields": []
      }
    ],
    "total": 0
  },
  "time": "2025-05-01T12:00:00Z"
}

POST /product/get-by-name ​

Find a product by its exact name.

Request body

FieldTypeRequiredDescription
namestringYes
json
{
  "name": "string"
}

Response

Same response shape as POST /product/create.

POST /product/get-by-barcode ​

Find a product by its barcode within an organization.

Request body

FieldTypeRequiredDescription
barcodestringYesbarcode of product to look up
organization_idstringYesorganization ObjectId to scope the lookup
json
{
  "barcode": "string",
  "organization_id": "string"
}

Response

Same response shape as POST /product/create.

POST /product/get-by-sku ​

Find a product by its SKU within an organization.

Request body

FieldTypeRequiredDescription
skustringYeslocal unique id (SKU) of product to look up
organization_idstringYesorganization ObjectId to scope the lookup
json
{
  "sku": "string",
  "organization_id": "string"
}

Response

Same response shape as POST /product/create.

POST /product/delete-many ​

Soft-delete multiple products by their ObjectIds. Each product is marked is_deleted=true; no physical deletion occurs. Products that are currently in stock, in transit, on-the-way, or booked cannot be deleted and will return an error.

Request body

FieldTypeRequiredDescription
idsstring[]YesList of product ObjectIds to soft-delete
json
{
  "ids": [
    "string"
  ]
}

Response

Same response shape as GET /product/get-deleted.

POST /product/update-status-many ​

Archive or unarchive multiple products by their ObjectIds. Set is_archived=true to archive, false to unarchive. Archived products remain visible but are excluded from active product lookups by default.

Request body

FieldTypeRequiredDescription
idsstring[]YesList of product ObjectIds to archive or unarchive
is_archivedbooleanNotrue to archive the products, false to unarchive them. Defaults to true when omitted.
json
{
  "ids": [
    "string"
  ],
  "is_archived": false
}

Response

Same response shape as GET /product/get-deleted.


This page is generated from the OpenAPI spec.

Bito 2.0 Integration API