Add a product nutrient row
Add a single nutrient row to the product’s nutrition panel. The header must exist first (422 otherwise). Each nutrient_type may appear at most once per label (409 on a duplicate). Requires the organization.contribute_organization permission on the membership.
Authorizations
Path Parameters
UUID of the organization that owns the product.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$GTIN-8/12/13/14 of the target product. Normalized to GTIN-14 by zero-padding before lookup.
^\d{8,14}$Body
Request body for adding a single nutrient row.
Canonical nutrient identifier. Each type may appear at most once per label.
CALORIES, TOTAL_FAT, SATURATED_FAT, TRANS_FAT, CHOLESTEROL, SODIUM, TOTAL_CARBS, DIETARY_FIBER, TOTAL_SUGARS, ADDED_SUGARS, PROTEIN, VITAMIN_D, CALCIUM, IRON, POTASSIUM "TOTAL_FAT"
Quantity of the nutrient per serving, in the units specified by unit.
x >= 08
Unit of measurement for amount. KCAL for calories; mass in G / MG / MCG; IU for vitamin activity-equivalent doses.
G, MG, MCG, KCAL, KJ, IU, ML "G"
Percent of the regulatory daily value (DV) covered by one serving. Null when DV is not declared.
x >= 010
Response
Created
A single nutrient row on a nutrition-facts label, with its row id.
URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$Canonical nutrient identifier. Stable across regulatory label formats.
CALORIES, TOTAL_FAT, SATURATED_FAT, TRANS_FAT, CHOLESTEROL, SODIUM, TOTAL_CARBS, DIETARY_FIBER, TOTAL_SUGARS, ADDED_SUGARS, PROTEIN, VITAMIN_D, CALCIUM, IRON, POTASSIUM Localized display name for the nutrient (e.g. Total Fat). Derived from nutrient_type.
Quantity of the nutrient per serving, in the units specified by unit.
x >= 0Unit of measurement for amount.
G, MG, MCG, KCAL, KJ, IU, ML Percent of the regulatory daily value covered by one serving. Null when not declared.
x >= 0