PUT /inventory-feed-variants/{id}.json

PUT /inventory-feed-variants/{id}.json

Path parameters

  • id integer(int64) Required

    Numeric ID of the instance

    Minimum value is 1.

application/json

Body Required

  • allocationBufferOverride integer(int32) | null

    Allocation buffer override

  • barcode string | null

    Barcode

  • cachedCompareAtPrice string | null

    Cached compare at price

  • cachedHandle string | null

    Cached handle

  • cachedName string | null

    Cached name

  • cachedRetailPrice string | null

    Cached retail price

  • cachedTags array[string] | null

    Cached tags

  • changesPending boolean | null Required

    Changes pending

    Default value is false.

  • compareAtPrice number | null

    Compare at price

  • costPrice number | null

    Cost price

  • countryOfOrigin string | null

    Country of origin

  • createdAt string(date-time)

    Created at

  • description string | null

    Description

  • distanceUnit string | null Required

    Distance unit

    Values are in or cm. Default value is in.

  • externalGroupId string | null

    External group

  • externalId string | null

    External

  • externalUrl string | null

    External url

  • grams number(float) | null Required

    Grams

    Default value is 0.

  • handle string | null

    Handle

  • hash string | null

    Hash

  • hsCode string | null

    Hs code

  • id integer(int32)

    Id

  • images object | null | array | boolean | integer | number | string Required

    Images

    Any of:

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

  • inventoryFeedId integer(int32) Required

    Inventory feed

  • inventoryPolicy string | null Required

    Inventory policy

    Values are ignore, deny, continue, dropship, or track. Default value is track.

  • inventoryQuantity integer(int32) | null

    Inventory quantity

  • inventoryQuantityOverride string | null

    By enabling this feature, you can manually set the inventory quantity for a specific variant in the inventory feed. This allows you to have more control over the displayed inventory quantity on the marketplace. If the quantity in the feed changes, the value you enter for the override will take precedence.

    Values are none, manual, or maximum.

  • inventoryUpdatedAt string(date-time) | null Required

    Inventory updated at

    Default value is {} (empty).

  • lastFetchedAt string(date-time) | null

    Last fetched at

  • manualInventoryPolicy boolean | null

    Manual inventory policy

  • manualInventoryQuantity integer(int32) | null

    Manual inventory quantity

  • mpn string | null

    Mpn

  • name string | null

    Name

  • options object | null | array | boolean | integer | number | string Required

    Options

    Any of:

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

    Default value is [] (empty).

  • originalCompareAtPrice number | null

    Original compare at price

  • originalInventoryQuantity integer(int32) | null

    Original inventory quantity

  • originalRetailPrice number | null

    Original retail price

  • originalSku string | null

    Original sku

  • packingDepth integer(int32) | null Required

    Packing depth

    Default value is 0.

  • packingHeight integer(int32) | null Required

    Packing height

    Default value is 0.

  • packingWidth integer(int32) | null Required

    Packing width

    Default value is 0.

  • position integer(int32) | null

    Position

  • priceUpdatedAt string(date-time) | null Required

    Price updated at

    Default value is {} (empty).

  • pricingOverride string | null Required

    Pricing override

    Values are none, manual, minimumGuidePrice, minimumGuidePricePercent, minimumGuidePriceFixed, or percent. Default value is none.

  • pricingOverrideUplift number | null

    Pricing override uplift

  • productType string | null

    Product type

  • requiresShipping boolean | null Required

    Requires shipping

    Default value is true.

  • retailPrice number | null

    Retail price

  • retriedPublishingAt string(date-time) | null

    Retried publishing at

  • retriedPublishingTimes integer(int32) | null

    Retried publishing times

  • retryPublishing boolean | null

    Retry publishing

  • retryPublishingParams object | null | array | boolean | integer | number | string

    Retry publishing params

  • reviewReasonId integer(int32) | null

    Review reason

  • reviewStatus string | null Required

    Review status

    Values are notReviewed, approved, pending, or rejected. Default value is notReviewed.

  • status string Required

    Status

    Values are pending, connected, error, removed, publishing, or queued. Default value is pending.

  • tags array[string] | null Required

    Tags

    Default value is [] (empty).

  • taxable boolean | null Required

    Taxable

    Default value is true.

  • uniqueOn string | null Required

    Unique on

    Values are none or externalId. Default value is none.

  • updatedAt string(date-time)

    Updated at

  • variantId integer(int32) | null

    Variant

  • vendorName string | null

    Vendor name

  • vendorSku string Required

    Vendor sku

PUT /inventory-feed-variants/{id}.json
curl \
 --request PUT 'http://api.example.com/v1/inventory-feed-variants/{id}.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"allocationBufferOverride":42,"barcode":"string","cachedCompareAtPrice":"string","cachedHandle":"string","cachedName":"string","cachedRetailPrice":"string","cachedTags":["string"],"changesPending":false,"compareAtPrice":42.0,"costPrice":42.0,"countryOfOrigin":"string","createdAt":"2025-05-04T09:42:00Z","description":"string","distanceUnit":"in","externalGroupId":"string","externalId":"string","externalUrl":"string","grams":0,"handle":"string","hash":"string","hsCode":"string","id":42,"images":[],"inventoryFeedId":42,"inventoryPolicy":"track","inventoryQuantity":42,"inventoryQuantityOverride":"none","inventoryUpdatedAt":{},"lastFetchedAt":"2025-05-04T09:42:00Z","locations":{},"manualInventoryPolicy":true,"manualInventoryQuantity":42,"messages":{},"metaFields":{},"mpn":"string","name":"string","options":[],"originalCompareAtPrice":42.0,"originalInventoryQuantity":42,"originalRetailPrice":42.0,"originalSku":"string","packingDepth":0,"packingHeight":0,"packingWidth":0,"position":42,"priceUpdatedAt":{},"pricingOverride":"none","pricingOverrideUplift":42.0,"productType":"string","publishProblem":{},"requiresShipping":true,"retailPrice":42.0,"retriedPublishingAt":"2025-05-04T09:42:00Z","retriedPublishingTimes":42,"retryPublishing":true,"retryPublishingParams":{},"reviewReasonId":42,"reviewStatus":"notReviewed","status":"pending","tags":[],"taxable":true,"uniqueOn":"none","updatedAt":"2025-05-04T09:42:00Z","variantId":42,"vendorName":"string","vendorSku":"string"}'
Request examples
{
  "allocationBufferOverride": 42,
  "barcode": "string",
  "cachedCompareAtPrice": "string",
  "cachedHandle": "string",
  "cachedName": "string",
  "cachedRetailPrice": "string",
  "cachedTags": [
    "string"
  ],
  "changesPending": false,
  "compareAtPrice": 42.0,
  "costPrice": 42.0,
  "countryOfOrigin": "string",
  "createdAt": "2025-05-04T09:42:00Z",
  "description": "string",
  "distanceUnit": "in",
  "externalGroupId": "string",
  "externalId": "string",
  "externalUrl": "string",
  "grams": 0,
  "handle": "string",
  "hash": "string",
  "hsCode": "string",
  "id": 42,
  "images": [],
  "inventoryFeedId": 42,
  "inventoryPolicy": "track",
  "inventoryQuantity": 42,
  "inventoryQuantityOverride": "none",
  "inventoryUpdatedAt": {},
  "lastFetchedAt": "2025-05-04T09:42:00Z",
  "locations": {},
  "manualInventoryPolicy": true,
  "manualInventoryQuantity": 42,
  "messages": {},
  "metaFields": {},
  "mpn": "string",
  "name": "string",
  "options": [],
  "originalCompareAtPrice": 42.0,
  "originalInventoryQuantity": 42,
  "originalRetailPrice": 42.0,
  "originalSku": "string",
  "packingDepth": 0,
  "packingHeight": 0,
  "packingWidth": 0,
  "position": 42,
  "priceUpdatedAt": {},
  "pricingOverride": "none",
  "pricingOverrideUplift": 42.0,
  "productType": "string",
  "publishProblem": {},
  "requiresShipping": true,
  "retailPrice": 42.0,
  "retriedPublishingAt": "2025-05-04T09:42:00Z",
  "retriedPublishingTimes": 42,
  "retryPublishing": true,
  "retryPublishingParams": {},
  "reviewReasonId": 42,
  "reviewStatus": "notReviewed",
  "status": "pending",
  "tags": [],
  "taxable": true,
  "uniqueOn": "none",
  "updatedAt": "2025-05-04T09:42:00Z",
  "variantId": 42,
  "vendorName": "string",
  "vendorSku": "string"
}