---
title: "Update Catalog"
method: PUT
path: "/catalog"
---

# Update Catalog

`PUT /catalog`

## Headers

- `api-token` string
- `x-api-key` string

## Request body

- object
  - `catalog_id` integer, required — A unique identifier for the catalog to which an item belongs.
  - `item_name` string, required — The name or title of the item, such as a product or service, used for identification and display purposes in catalogs, invoices, and other records.
  - `item_type` 'Goods' | 'Services', required — Specifies the category or classification of the item, such as goods, service, or other predefined types.
  - `gst_rate` '18%' | 'Nil-Rated' | 'Zero-Rated' | 'Exempted Supply' | 'Non-GST Supply' | '0%' | '0.1%' | '0.25%' | '1%' | '1.5%' | '3%' | '5%' | '7.5%' | '12%' | '28%', required — GST rate which is approved by gov. filing portal
  - `price` number, float, required — The monetary value assigned to an item, typically representing the selling or purchase cost per unit.
  - `units` 'UNT-UNITS' | 'BAG-BAGS' | 'BAL-BALE' | 'BDL-BUNDLES' | 'BKL-BUCKLES' | 'BOU-BILLIONS OF UNITS' | 'BOX-BOX' | 'BTL-BOTTLES' | 'BUN-BUNCHES' | 'CAN-CANS' | 'CBM-CUBIC METERS' | 'CCM-CUBIC CENTIMETERS' | 'CMC-CENTIMETERS' | 'CTN-CARTONS' | 'DOZ-DOZENS' | 'DRM-DRUMS' | 'GGK-GREAT GROSS' | 'GMS-GRAMMES' | 'GRS-GROSS' | 'GYD-GROSS YARDS' | 'KGS-KILOGRAMS' | 'KLR-KILOLITRE' | 'KME-KILOMETRE' | 'MLT-MILILITRE' | 'MTR-METERS' | 'MTS-METRIC TON' | 'NOS-NUMBERS' | 'OTH-OTHERS' | 'PAC-PACKS' | 'PCS-PIECES' | 'PRS-PAIRS' | 'QTL-QUINTAL' | 'ROL-ROLLS' | 'SET-SETS' | 'SQF-SQUARE FEET' | 'SQM-SQUARE METERS' | 'SQY-SQUARE YARDS' | 'TBS-TABLETS' | 'TGM-TEN GROSS' | 'THD-THOUSANDS' | 'TON-TONNES' | 'TUB-TUBES' | 'UGS-US GALLONS' | 'YDS-YARDS', required — Units as per dropdown.
  - `catalog_type` 'sales' | 'purchase', required — Defines the type or purpose of the catalog the item belongs to, such as sales, purchase, or inventory.
  - `hsn_sac` string — The HSN (Harmonized System of Nomenclature) or SAC (Service Accounting Code) assigned to a product or service under the GST framework in India.
  - `cess` number, float — The additional tax (Cess) amount or rate applied on top of the standard GST, as mandated for specific goods or services (such as luxury items or sin goods).This value can be a fixed amount or a percentage, depending on the item classification.
  - `description` string — A detailed explanation or summary of the item, including its features, specifications, usage, or any other relevant information.
  - `variants` object[], required
    - `variant_name` string — The currency in which the variant's price is defined.
    - `price` string — The price of the variant.
    - `gst_type` 'inclusive of gst' | 'exclusive of gst' — GST type inclusive of GST or Exclusive of GST
    - `variant_description` string — A description of the variant, providing additional details.
    - `non_taxable` string — The amount of the variant's price that is non-taxable.
    - `currency` 'INR' | 'CNY' | 'USD' | 'IDR' | 'PKR' | 'NGN' | 'BRL' | 'BDT' | 'RUB' | 'ETB' | 'MXN' | 'JPY' | 'PHP' | 'EGP' | 'CDF' | 'VND' | 'IRR' | 'TRY' | 'EUR' | 'THB' | 'TZS' | 'GBP' | 'ZAR' | 'KES' | 'MMK' | 'COP' | 'KRW' | 'UGX' | 'SDG' | 'IQD' | 'DZD' | 'ARS' | 'AFN' | 'PLN' | 'CAD' | 'MAD' | 'UAH' | 'AOA' | 'SAR' | 'UZS' | 'YER' | 'MZN' | 'GHS' | 'PEN' | 'MYR' | 'NPR' | 'MGA' | 'VES' | 'XAF' | 'XOF' | 'AUD' | 'KPW' | 'SYP' | 'TWD' | 'LKR' | 'MWK' | 'ZMW' | 'KZT' | 'CLP' | 'RON' | 'SOS' | 'GTQ' | 'KHR' | 'ZWB' | 'GNF' | 'RWF' | 'BIF' | 'BOB' | 'TND' | 'HTG' | 'DOP' | 'JOD' | 'SSP' | 'CUP' | 'HNL' | 'SEK' | 'PGK' | 'CZK' | 'AZN' | 'TJS' | 'HUF' | 'AED' | 'BYN' | 'ILS' | 'SLL' | 'CHF' | 'LAK' | 'HKD' | 'NIO' | 'RSD' | 'LYD' | 'PYG' | 'KGS' | 'BGN' | 'TMT' | 'SGD' | 'DKK' | 'LRD' | 'NOK' | 'NZD' | 'CRC' | 'LBP' | 'MRU' | 'OMR' | 'PAB' | 'KWD' | 'ERN' | 'GEL' | 'MNT' | 'UYU' | 'MDL' | 'BAM' | 'GMD' | 'ALL' | 'JMD' | 'AMD' | 'QAR' | 'BWP' | 'NAD' | 'LSL' | 'MKD' | 'TTD' | 'BHD' | 'MUR' | 'SZL' | 'DJF' | 'FJD' | 'KMF' | 'GYD' | 'BTN' | 'SBD' | 'MOP' | 'SRD' | 'CVE' | 'MVR' | 'BND' | 'BZD' | 'BSD' | 'ISK' | 'VUV' | 'XPF' | 'BBD' | 'STN' | 'WST' | 'XCD' | 'KID' | 'JEP' | 'TOP' | 'SCR' | 'AWG' | 'IMP' | 'KYD' | 'BMD' | 'GGP' | 'ANG' | 'GIP' | 'CKD' | 'TVD' | 'FKP' — The currency in which the variant's price is defined.
    - `sku_id` string — The Stock Keeping Unit (SKU) identifier for inventory tracking.

## Response `200`

200

- object
  - `status` integer
  - `message` string
  - `catalog_id` integer

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `500` — 500
- `501` — 501
- `502` — 502
- `503` — 503

---

[API](https://skmtc.dev/ledgers/apis/authentication.md) · [All operations](https://skmtc.dev/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ledgers/authentication/revisions/605f28ef08ef/schema)