Product V2

Update an item

Changed on Nov 3, 2026

Updates an item's master record in the catalog. This is the only way to change catalog details — item fields sent inside a document apply to that document only.

put/v2/product

Request

Base URL
https://app.getswipe.in/api/partner
URL
https://app.getswipe.in/api/partner/v2/product
Auth
HTTP bearer

Query parameters

idstring required

Unique id for each item

namestring required

Name of the Product

quantitynumber required

Opening Quantity

unit_pricenumber required

Price per item without Tax

tax_ratenumber

Tax percentage for each item

price_with_taxnumber required

Price per item with Tax

purchase_price_with_taxnumber

Purchase Price per item with Tax

descriptionstring

Item Description

hsn_codestring

HSN Code

item_typestring required

Product or Service enum

unitstring

Item quantity unit

cess_ratenumber

Cess Percent of the Item

cess_amountnumber

Cess Amount of the Item

barcodestring

Barcode

categorystring

Request body multipart/form-data

product_imagesstring[]

Product images (multiple files supported)

Response

Success

successboolean

Success flag

messagestring

Response message

error_codestring

Error Code

errorsobject

Errors

Example response

{
  "success": true,
  "message": "Message",
  "data": {
    "message": "No data found!"
  }
}

Changes

Nov 3, 20260bcdbc62187b Revision changes
- breaking
  added the new required query request parameter id
- breaking
  added the new required query request parameter item_type
- breaking
  added the new required query request parameter name
- breaking
  added the new required query request parameter price_with_tax
- breaking
  added the new required query request parameter quantity
- breaking
  added the new required query request parameter unit_price
- breaking
  removed the media type application/json from the request body
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- info
  api operation id v2_put_product removed and replaced with put_product
- info
  added the new optional query request parameter alternative_units
- info
  added the new optional query request parameter barcode
- info
  added the new optional query request parameter category
- info
  added the new optional query request parameter cess_amount
- info
  added the new optional query request parameter cess_rate
- info
  added the new optional query request parameter custom_columns
- info
  added the new optional query request parameter description
- info
  added the new optional query request parameter hsn_code
- info
  added the new optional query request parameter preferences
- info
  added the new optional query request parameter purchase_price_with_tax
- info
  added the new optional query request parameter tax_rate
- info
  added the new optional query request parameter unit
- info
  request body became optional

Operation history