WHwhatnot
Products

Update a product

Partially update a product; omitted fields are unchanged. Use merchandising APIs to update the transaction type, add to shows, or make available for sale on your profile shop.

patch/products/{product_id}

Request

  • Base URL
    https://api.whatnot.com/seller-api/rest/v2
  • URL
    https://api.whatnot.com/seller-api/rest/v2/products/{product_id}
  • Auth
    OAuth 2
    Authorization code: https://api.whatnot.com/seller-api/rest/oauth/authorize
    Token URL: https://api.whatnot.com/seller-api/rest/oauth/token

Path parameters

product_idstring required

The product's ID.

Request body

titlestring nullable

The product's title.

descriptionstring nullable

The product's description.

external_idstring nullable

The seller-provided external identifier for the product.

Response

Successful Response

idstring nullable

The product's id.

titlestring required

The product's title.

descriptionstring nullable

The product's description.

external_idstring nullable

The seller-provided external identifier for the product.

urlstring nullable

The url of the product in the seller's inventory dashboard.

created_atstring date-time nullable

When the product was created.

updated_atstring date-time nullable

When the product was last updated.

Example response

{
  "attributes": [
    {
      "id": "7",
      "name": "Condition",
      "value": "Near Mint"
    }
  ],
  "category": {
    "id": "42",
    "name": "Trading Cards"
  },
  "created_at": "2026-01-15T12:00:00.000Z",
  "description": "A very rare card.",
  "dimension_profile": {
    "active": true,
    "dimensions": {
      "height": 1,
      "length": 6,
      "unit": "inch",
      "width": 4
    },
    "id": "88",
    "name": "API 4 oz",
    "ownership": "seller",
    "weight": {
      "unit": "ounce",
      "value": 4
    }
  },
  "external_id": "ext-123",
  "id": "12345",
  "media": [
    {
      "alt": "front",
      "id": "555",
      "url": "https://cdn.whatnot.com/i/555.jpg"
    }
  ],
  "options": [
    {
      "id": "1001",
      "name": "Color",
      "values": [
        "Red",
        "Blue"
      ]
    }
  ],
  "title": "Rare Holographic Card",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "url": "https://www.whatnot.com/product/abc123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.