cURL
curl --request PUT \
--url https://api-staging.getmeadow.com/api/v1/products/{productId} \
--header 'Content-Type: application/json' \
--header 'X-Client-Key: <api-key>' \
--header 'X-Consumer-Key: <api-key>' \
--data '
{
"name": "Blue Dream",
"unit": "gram",
"strainType": "hybrid-sativa",
"category": "Flower",
"subCategories": [
"Top Shelf"
],
"brandName": "Awesome Cannabis",
"photos": [
"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg",
"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"
]
}
'import requests
url = "https://api-staging.getmeadow.com/api/v1/products/{productId}"
payload = {
"name": "Blue Dream",
"unit": "gram",
"strainType": "hybrid-sativa",
"category": "Flower",
"subCategories": ["Top Shelf"],
"brandName": "Awesome Cannabis",
"photos": ["https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg", "https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"]
}
headers = {
"X-Consumer-Key": "<api-key>",
"X-Client-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'X-Consumer-Key': '<api-key>',
'X-Client-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Blue Dream',
unit: 'gram',
strainType: 'hybrid-sativa',
category: 'Flower',
subCategories: ['Top Shelf'],
brandName: 'Awesome Cannabis',
photos: [
'https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg',
'https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg'
]
})
};
fetch('https://api-staging.getmeadow.com/api/v1/products/{productId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.getmeadow.com/api/v1/products/{productId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Blue Dream',
'unit' => 'gram',
'strainType' => 'hybrid-sativa',
'category' => 'Flower',
'subCategories' => [
'Top Shelf'
],
'brandName' => 'Awesome Cannabis',
'photos' => [
'https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg',
'https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Client-Key: <api-key>",
"X-Consumer-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-staging.getmeadow.com/api/v1/products/{productId}"
payload := strings.NewReader("{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Consumer-Key", "<api-key>")
req.Header.Add("X-Client-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api-staging.getmeadow.com/api/v1/products/{productId}")
.header("X-Consumer-Key", "<api-key>")
.header("X-Client-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.getmeadow.com/api/v1/products/{productId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Consumer-Key"] = '<api-key>'
request["X-Client-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 11867,
"organizationId": 25,
"brand": {
"id": 2238,
"name": "Awesome Cannabis",
"createdAt": "2024-12-12T03:08:58.012Z",
"updatedAt": "2024-12-12T03:08:58.012Z",
"description": null
},
"subCategories": [
{
"id": 30325,
"organizationId": 25,
"name": "Top Shelf",
"createdAt": "2024-12-12T03:01:11.823Z",
"updatedAt": "2024-12-12T03:01:11.823Z"
}
],
"inventoryType": "option",
"createdAt": "2024-12-12T04:08:00.429Z",
"updatedAt": "2024-12-12T04:08:00.429Z",
"isActive": false,
"isFeatured": false,
"photos": [
"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg",
"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"
],
"name": "Blue Dream",
"strainType": "hybrid-sativa",
"isCompliant": true,
"unit": "gram",
"primaryCategory": {
"id": 286,
"name": "Flower",
"createdAt": "2023-12-16T02:51:28.738Z",
"updatedAt": "2023-12-16T02:51:28.738Z",
"cannabisType": "non-concentrated"
},
"options": [
{
"id": 15472,
"name": "Eighth",
"amount": 3.5,
"price": 4500,
"salesPrice": null,
"createdAt": "2024-12-12T04:08:00.433Z",
"updatedAt": "2024-12-12T04:08:00.433Z",
"upc": null,
"content": "3.5"
}
],
"thcAmount": "12",
"thcAmountEach": "12",
"thcAmountRangeLow": null,
"thcAmountRangeHigh": null,
"thcUnit": "mg",
"cbdAmount": null,
"cbdAmountEach": null,
"cbdAmountRangeLow": null,
"cbdAmountRangeHigh": null,
"cbdUnit": null
}
}{
"error": {
"message": "A description of the error code",
"code": "CODE_OF_ERROR_WILL_BE_HERE"
}
}Endpoints: Products & Inventory
Update a product
PUT
/
api
/
v1
/
products
/
{productId}
cURL
curl --request PUT \
--url https://api-staging.getmeadow.com/api/v1/products/{productId} \
--header 'Content-Type: application/json' \
--header 'X-Client-Key: <api-key>' \
--header 'X-Consumer-Key: <api-key>' \
--data '
{
"name": "Blue Dream",
"unit": "gram",
"strainType": "hybrid-sativa",
"category": "Flower",
"subCategories": [
"Top Shelf"
],
"brandName": "Awesome Cannabis",
"photos": [
"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg",
"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"
]
}
'import requests
url = "https://api-staging.getmeadow.com/api/v1/products/{productId}"
payload = {
"name": "Blue Dream",
"unit": "gram",
"strainType": "hybrid-sativa",
"category": "Flower",
"subCategories": ["Top Shelf"],
"brandName": "Awesome Cannabis",
"photos": ["https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg", "https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"]
}
headers = {
"X-Consumer-Key": "<api-key>",
"X-Client-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'X-Consumer-Key': '<api-key>',
'X-Client-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Blue Dream',
unit: 'gram',
strainType: 'hybrid-sativa',
category: 'Flower',
subCategories: ['Top Shelf'],
brandName: 'Awesome Cannabis',
photos: [
'https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg',
'https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg'
]
})
};
fetch('https://api-staging.getmeadow.com/api/v1/products/{productId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.getmeadow.com/api/v1/products/{productId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Blue Dream',
'unit' => 'gram',
'strainType' => 'hybrid-sativa',
'category' => 'Flower',
'subCategories' => [
'Top Shelf'
],
'brandName' => 'Awesome Cannabis',
'photos' => [
'https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg',
'https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Client-Key: <api-key>",
"X-Consumer-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-staging.getmeadow.com/api/v1/products/{productId}"
payload := strings.NewReader("{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Consumer-Key", "<api-key>")
req.Header.Add("X-Client-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api-staging.getmeadow.com/api/v1/products/{productId}")
.header("X-Consumer-Key", "<api-key>")
.header("X-Client-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.getmeadow.com/api/v1/products/{productId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Consumer-Key"] = '<api-key>'
request["X-Client-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Blue Dream\",\n \"unit\": \"gram\",\n \"strainType\": \"hybrid-sativa\",\n \"category\": \"Flower\",\n \"subCategories\": [\n \"Top Shelf\"\n ],\n \"brandName\": \"Awesome Cannabis\",\n \"photos\": [\n \"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg\",\n \"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 11867,
"organizationId": 25,
"brand": {
"id": 2238,
"name": "Awesome Cannabis",
"createdAt": "2024-12-12T03:08:58.012Z",
"updatedAt": "2024-12-12T03:08:58.012Z",
"description": null
},
"subCategories": [
{
"id": 30325,
"organizationId": 25,
"name": "Top Shelf",
"createdAt": "2024-12-12T03:01:11.823Z",
"updatedAt": "2024-12-12T03:01:11.823Z"
}
],
"inventoryType": "option",
"createdAt": "2024-12-12T04:08:00.429Z",
"updatedAt": "2024-12-12T04:08:00.429Z",
"isActive": false,
"isFeatured": false,
"photos": [
"https://meadow.imgix.net/2024/10/1aef02cf-9150-481e-9625-760693b4186b.jpeg",
"https://meadow.imgix.net/2022/11/67de83f8-1d72-4713-991a-87c3b29d4e93.jpeg"
],
"name": "Blue Dream",
"strainType": "hybrid-sativa",
"isCompliant": true,
"unit": "gram",
"primaryCategory": {
"id": 286,
"name": "Flower",
"createdAt": "2023-12-16T02:51:28.738Z",
"updatedAt": "2023-12-16T02:51:28.738Z",
"cannabisType": "non-concentrated"
},
"options": [
{
"id": 15472,
"name": "Eighth",
"amount": 3.5,
"price": 4500,
"salesPrice": null,
"createdAt": "2024-12-12T04:08:00.433Z",
"updatedAt": "2024-12-12T04:08:00.433Z",
"upc": null,
"content": "3.5"
}
],
"thcAmount": "12",
"thcAmountEach": "12",
"thcAmountRangeLow": null,
"thcAmountRangeHigh": null,
"thcUnit": "mg",
"cbdAmount": null,
"cbdAmountEach": null,
"cbdAmountRangeLow": null,
"cbdAmountRangeHigh": null,
"cbdUnit": null
}
}{
"error": {
"message": "A description of the error code",
"code": "CODE_OF_ERROR_WILL_BE_HERE"
}
}Authorizations
The key assigned to your company and provided via Meadow
The key generated and provided by our mutual client
Path Parameters
ID of the product to update
Body
application/json
The name of the product, excluding any brand names.
A description for the product shown on menus. (Supports markdown)
Set to gram when this product is in a category which is weighed out (i.e. "Flowers"), otherwise set to item
Available options:
gram, item The strain type of the cannabis product, none otherwise.
Available options:
sativa, indica, hybrid, hybrid-sativa, hybrid-indica, cbd, mixed, none A category name from the List categories endpoint. Please note that different client organizations may customize category names, for example renaming "Flowers" to "Flower."
A list of sub category names from the List sub-categories endpoint, or a new sub category name. Pass an empty array [] to have no sub categories.
The brand of the product. Meadow will match this to an existing brand or create a new brand if it does not exist.
URLs for the image to associate with this product. Meadow will download with a background job. Max photo size is 15MB.
The inventory type of this product. Please see the Inventory Guide for more information.
Available options:
option, product, none Set to current ISO 8601 timestamp to delete product
The total amount of THC present in this product
The amount of THC per each unit of the product (i.e. 10mg per pre-roll in a pack of 15 pre-rolls)
The low value of a range if this product has a range of THC value.
The high value of a range if this product has a range of THC value.
The unit for the THC values submitted. Must be specified if any of the THC amount fields are provided.
Available options:
%, mg The total amount of CBD present in this product
The amount of CBD per each unit of the product (i.e. 10mg per pre-roll in a pack of 15 pre-rolls)
The low value of a range if this product has a range of CBD value.
The high value of a range if this product has a range of CBD value.
The unit for the CBD values submitted. Must be specified if any of the CBD amount fields are provided.
Available options:
%, mg Response
Update product response
The ID of the new product
The client organization's ID
The name of the product
The description of the product
Either gram or item
Whether this product is shown on the menu. Client organizations must update this via Meadow.
Whether this product is shown as featured. Client organizations must update this via Meadow.
The category of this product
Hide child attributes
Hide child attributes
Photo URLs submitted in the request
The purchaseable options for this product
Hide child attributes
Hide child attributes
The ID of this option
The name of this option
The price of this option in cents
The sales price of this option in cents
The cannabis content of this option
The UPC for this option
The total amount of THC present in this product
The amount of THC per each unit of the product (i.e. 10mg per pre-roll in a pack of 15 pre-rolls)
The low value of a range if this product has a range of THC value.
The high value of a range if this product has a range of THC value.
The unit for the THC values submitted.
Available options:
%, mg The total amount of CBD present in this product
The amount of CBD per each unit of the product (i.e. 10mg per pre-roll in a pack of 15 pre-rolls)
The low value of a range if this product has a range of CBD value.
The high value of a range if this product has a range of CBD value.
The unit for the CBD values submitted.
Available options:
%, mg