GuidesAPI EndpointsChangelog
Log In
API Endpoints

Update a Menu Item

This operation will update an existing Menu Item by its Weedmaps identifier.

  • You can atomically sync Menu Items from your point-of-sale- adjusting price and inventory levels.
  • You can leverage this operation to enrich your Menu Items by linking a Brand, Brand Product, Strain, Categories, Cannabinoids, Discovery Tags, and Terpenes.

🚨 Important 🚨 A note on updating the product_id or brand_id:

Manual Brand linking performed by retailers or Weedmaps—whether through our mutual client or curation services—are intentional and high-value.

Do not overwrite these links, unless they have explicitly changed, and we urge you to send the replacement Weedmaps Brand identifier in its place.

Overwriting manually linked products undermines the integrity of curated content and significantly reduces the effectiveness of our joint efforts.

You should only send attributes that have been changed on your end.


Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
Body Params
category_ids
array of int32s
required

The primary identifier for a root Weedmaps Category and all Sub-Category identifiers.

category_ids*
integer

The primary identifier for a Weedmaps Brand.

string

The custom brand name for this Menu Item, which will be used to autolink to a matching brand on Weedmaps (if applicable); cannot be combined with brand_id

cannabinoids
array of objects

List of Cannabinoid Measurements. You can provide the id or slug as an identifier.

cannabinoids
int32 | null

An Integer timestamp of last image update. This can be updated to force a re-download of a previously cached image.

integer

The primary identifier for a Weedmaps Brand Product. If this Menu Item is linked with a valid product_id it will override *some Menu Item attributes with the Brand's official details for their Product.

sale
object
deprecated

The Sale Price to apply to the Menu Item. This will be displayed on the Menu Item and display the price of the Menu Item as a ~strike-through~ price. The Sale Price will override the Price through Weedmaps Orders flow.

integer

A Weedmaps Strain identifier. Mutually exclusive with the strain_name field.

string

If you do not have a Weedmaps Strain identifier, this additional property will attempt to match to a Strain in the Weedmaps Taxonomy. Providing a Weedmaps strain_id is the preferred method and will provide the best results for Menu Item and overall Menu quality.

tag_ids
array of objects

List of Weedmaps Discovery Tag identifiers. Mutually exclusive with the field tag_names.

tag_ids
tag_names
array of strings

If you do not have Weedmaps Discovery Tag identifiers, this additional property will attempt to match to Discovery Tags in the Weedmaps Taxonomy. Providing Weedmaps tag_ids is the preferred method and will provide the best results for Menu Item and overall Menu quality. Mutually exclusive with the field tag_ids.

tag_names
terpenes
array of objects

List of Terpenes Measurements. You can provide an id or slug as the identifier.

terpenes
variants
array of objects
variants
string

The description for this Menu Item that is displayed on Weedmaps.

string
required

This field represents your internal retail client's purchasable item's identifier.

string | null

This field represents your the Brand Product identifier that is linked to your inventory item.

string | null
enum

The genetics classification of this resource

Allowed:
string

Image displayed for this Resource.

string

The name that is displayed on a Weedmaps.

boolean

This field controls the public visibility of on Weedmaps.

compliance
object | null
deprecated

The compliance information for this item.

float
≥ 1
deprecated

This represents the quantity used through the Weedmaps Order flow. It defaults to 1.0.

int32
≥ 1
deprecated

The amount of available for purchase

int32
≥ 1
deprecated

Items per pack for this item.

string | null
deprecated

The license requirements to purchase Menu Item.

boolean
deprecated

This determines if this Item can be added to a cart and go through a Weedmaps Order flow.

price
object
deprecated
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json