Skip to main content
PUT
/
stores
/
{store_id}
/
menus
/
{menu_id}
/
items
/
{item_id}
Update Menu Item
curl --request PUT \
  --url 'https://api.example.com/stores/{{store_id}}/menus/{{menu_id}}/items/{{item_id}}' \
  --header 'Content-Type: application/json' \
  --data '
{
  "is_available": true,
  "menu_specific_price": 123,
  "display_order": 123,
  "menu_item_description": "<string>",
  "promotional_tags": [
    {}
  ],
  "menu_item_modifiers": {}
}
'
{
  "message": "<string>",
  "success": true,
  "updated_item": {}
}

Documentation Index

Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint provides comprehensive menu item update capabilities, allowing businesses to adjust item properties, pricing, availability, and other menu-specific configurations while maintaining system consistency.
Menu item updates enable dynamic menu management, allowing businesses to respond to inventory changes, promotional requirements, and operational needs in real-time.

​
Path Parameters

​
store_id
string
required
The unique identifier of the store containing the menu
​
menu_id
string
required
The unique identifier of the menu containing the item to update
​
item_id
string
required
The unique identifier of the item to update

​
Request Body

​
is_available
boolean
Controls whether the item is available for ordering in this menu
​
menu_specific_price
number
Custom pricing for this item within this specific menu (overrides base item price)
​
display_order
integer
Controls the display order of the item within the menu
​
menu_item_description
string
Menu-specific description that overrides the default item description
​
promotional_tags
array
Array of promotional tags specific to this menu item association
​
menu_item_modifiers
object
Menu-specific modifier configurations for this item

​
Request Example

{
    "is_available": true,
    "menu_specific_price": 12.99,
    "display_order": 5,
    "menu_item_description": "Fresh grilled salmon with seasonal vegetables",
    "promotional_tags": ["featured", "healthy"],
    "menu_item_modifiers": {
        "cooking_preferences": ["medium", "well-done"],
        "side_options": ["rice", "vegetables", "salad"]
    }
}

​
Response

​
message
string
Confirmation message indicating the operation result
​
success
boolean
Whether the update operation completed successfully
​
updated_item
object
Details of the updated menu item configuration

​
Response Example

{
    "message": "Menu item updated successfully",
    "success": true,
    "updated_item": {
        "item_id": "c81d64ff-0651-48af-ab61-9b503be9f020",
        "menu_id": "813f8ac7-cae5-4d2d-92ef-d6798547f95c",
        "is_available": true,
        "menu_specific_price": 12.99,
        "display_order": 5,
        "last_updated": "2024-01-15T10:30:00Z"
    }
}
Menu-Specific Settings: Updates apply only to the specific menu-item association. The base item properties remain unchanged unless specifically modified through item management endpoints.
Batch Updates: For updating multiple items with similar changes, consider implementing batch update logic in your application to reduce API calls and improve performance.

​
Use Cases

Dynamic Availability Management
  • Toggle item availability based on inventory levels
  • Handle equipment maintenance affecting specific items
  • Manage staffing limitations for complex preparations
  • Control availability during special events or promotions
Promotional Campaigns
  • Update pricing for limited-time offers
  • Add promotional tags and descriptions
  • Adjust display order to feature promoted items
  • Configure special modifiers for promotional periods
Seasonal Adjustments
  • Update descriptions to reflect seasonal ingredients
  • Adjust pricing for seasonal cost variations
  • Modify availability based on seasonal supply
  • Update promotional tags for seasonal marketing
Menu Optimization
  • Reorder items based on performance data
  • Update descriptions based on customer feedback
  • Adjust pricing based on market analysis
  • Optimize modifier configurations for efficiency

​
Update Field Details

Availability Control
  • is_available: Controls immediate customer access to the item
  • Affects all customer-facing systems and ordering platforms
  • Does not remove the item from the menu structure
  • Enables quick response to operational changes
Pricing Management
  • menu_specific_price: Overrides base item pricing for this menu
  • Supports menu-specific pricing strategies
  • Enables promotional pricing without affecting other menus
  • Maintains pricing flexibility across different contexts
Display Optimization
  • display_order: Controls item position within menu sections
  • Lower numbers appear first in the display order
  • Enables strategic positioning of high-margin or popular items
  • Supports logical grouping and customer flow optimization
Content Customization
  • menu_item_description: Menu-specific item description
  • Overrides base item description for this menu context
  • Supports targeted messaging for specific customer segments
  • Enables localization and customization
Promotional Enhancement
  • promotional_tags: Array of tags for marketing and display
  • Supports visual highlighting in customer interfaces
  • Enables filtering and categorization for promotions
  • Provides metadata for analytics and reporting
Modifier Configuration
  • menu_item_modifiers: Menu-specific modifier settings
  • Allows different modifier options per menu
  • Supports context-appropriate customization options
  • Enables menu-specific operational workflows

​
Validation Rules

Menu and Item Validation
  • Menu ID must exist and belong to the specified store
  • Item ID must exist and be associated with the specified menu
  • User must have appropriate permissions for menu modifications
  • Menu must be in a valid state for updates
Data Validation
  • Pricing values must be positive numbers with appropriate precision
  • Display order must be a valid integer
  • Description length must be within system limits
  • Promotional tags must be from approved tag sets
Business Rule Validation
  • Price changes must comply with business pricing policies
  • Availability changes must consider inventory and operational constraints
  • Display order changes must maintain menu structure integrity
  • Modifier configurations must be valid for the item type
System Validation
  • All referenced modifiers and options must exist
  • Promotional tags must be valid and active
  • Price formats must match system requirements
  • Description content must meet content policy requirements

​
Error Handling

Invalid Menu Item Association
{
  "error": "Menu item not found",
  "message": "The specified item is not associated with this menu",
  "details": {
    "menu_id": "813f8ac7-cae5-4d2d-92ef-d6798547f95c",
    "item_id": "invalid-item-id"
  }
}
Invalid Price Value
{
  "error": "Invalid price",
  "message": "Menu specific price must be a positive number",
  "provided_value": -5.99
}
Permission Denied
{
  "error": "Permission denied",
  "message": "Insufficient permissions to update items in this menu"
}
Business Rule Violation
{
  "error": "Business rule violation",
  "message": "Price change exceeds maximum allowed variance from base price",
  "details": {
    "base_price": 10.99,
    "requested_price": 25.99,
    "max_variance": "50%"
  }
}

​
Best Practices

​
Integration Patterns

Real-time Synchronization
  • Ensure immediate propagation to all customer-facing systems
  • Update point-of-sale systems with current item configurations
  • Synchronize with mobile apps and online ordering platforms
  • Coordinate with third-party delivery and ordering services
Inventory Integration
  • Sync availability updates with inventory management systems
  • Automatically adjust availability based on stock levels
  • Coordinate pricing updates with cost management systems
  • Integrate with procurement and supply chain systems
Analytics and Reporting
  • Track update patterns and their impact on sales
  • Monitor customer response to pricing and availability changes
  • Generate insights for menu optimization strategies
  • Support data-driven decision making
Customer Experience Integration
  • Ensure consistent presentation across all customer touchpoints
  • Update search and recommendation algorithms with new configurations
  • Maintain accurate nutritional and allergen information
  • Support personalization and customer preference systems
Introduction Phase
  • Set initial availability and pricing
  • Configure promotional tags for new item launches
  • Optimize display order for customer discovery
  • Monitor performance and adjust configuration accordingly
Growth and Optimization
  • Adjust pricing based on demand and cost analysis
  • Optimize display order based on customer behavior
  • Update descriptions based on customer feedback
  • Fine-tune modifier configurations for operational efficiency
Maturity Management
  • Maintain optimal pricing and positioning
  • Adjust availability based on inventory optimization
  • Update promotional strategies based on market position
  • Monitor competitive positioning and adjust accordingly
Decline and Phase-out
  • Gradually reduce visibility through display order adjustments
  • Implement clearance pricing strategies
  • Manage availability during inventory depletion
  • Plan removal strategy while maintaining customer satisfaction

​
Performance Monitoring

Customer Impact Analysis
  • Track ordering patterns before and after updates
  • Monitor customer feedback and satisfaction scores
  • Analyze impact on average order value and frequency
  • Measure customer discovery and selection rates
Operational Impact Assessment
  • Monitor kitchen efficiency and preparation times
  • Track inventory turnover and waste reduction
  • Analyze staff efficiency with updated configurations
  • Measure overall operational performance changes
Business Performance Metrics
  • Track revenue impact of pricing and availability changes
  • Monitor profit margin improvements from optimization
  • Analyze competitive positioning and market share
  • Measure ROI of menu management activities
System Performance Monitoring
  • Track API response times and system performance
  • Monitor integration effectiveness across platforms
  • Analyze data consistency and synchronization success
  • Measure customer experience quality across touchpoints