This endpoint allows modification of existing promotions while maintaining data integrity and ensuring business rules are followed. Different fields have varying update restrictions based on promotion status.
Promotion updates are subject to status-based restrictions. Active promotions have limited modifiable fields to prevent disruption to ongoing customer experiences, while draft promotions can be freely modified.
{ "promotion_id": "promo_spring_001", "campaign_id": "1000010", "promotion_name": "Spring Fresh 25% Off - Extended", "status": "active", "updates_applied": [ "promotion_name", "description", "discount_rules.discount_value", "discount_rules.max_discount_amount", "discount_rules.applicable_categories", "usage_limits.total_usage_limit", "usage_limits.per_customer_limit", "schedule.end_date", "schedule.time_restrictions", "display_settings.promotional_message", "display_settings.banner_text", "display_settings.priority_level" ], "updates_rejected": [ { "field": "discount_rules.min_purchase_amount", "reason": "Cannot decrease minimum purchase amount for active promotion with existing usage", "current_value": "25.00" } ], "discount_rules": { "discount_value": 25, "max_discount_amount": 75.00, "min_purchase_amount": 25.00, "applicable_categories": ["fresh_produce", "organic_items", "seasonal_items"], "excluded_items": ["premium_organics"] }, "eligibility_criteria": { "customer_segments": ["regular_customers", "premium_members"], "first_time_customers_only": false, "loyalty_tier_requirements": ["bronze", "silver", "gold"], "geographic_restrictions": ["northeast_region"] }, "usage_limits": { "total_usage_limit": 1500, "per_customer_limit": 5, "daily_usage_limit": 150, "current_usage": { "total_used": 247, "today_used": 18, "remaining_uses": 1253, "unique_customers": 189 } }, "schedule": { "start_date": "2025-04-14T00:00:00.000Z", "end_date": "2025-05-31T23:59:59.000Z", "time_restrictions": { "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday"], "hours_of_day": { "start": "06:00", "end": "22:00" } } }, "display_settings": { "promotional_message": "Save 25% on Fresh Spring Produce - Extended Through May!", "banner_text": "SPRING20 - Even More Fresh Savings!", "badge_style": "seasonal_green", "priority_level": 9 }, "performance_impact": { "estimated_usage_change": "Increased usage expected due to higher discount and extended availability", "revenue_impact_estimate": "Positive impact expected despite higher discount due to extended duration", "customer_impact_notes": [ "Existing customers will see improved offer", "Extended weekend availability may increase usage", "Higher discount may attract new customer segments" ] }, "validation_warnings": [ "Increasing discount from 20% to 25% will reduce profit margins", "Extended end date overlaps with Memorial Day weekend - consider holiday impact" ], "last_updated": "2025-04-20T15:45:00.000Z", "updated_by": "marketing_manager_002", "update_history": [ { "timestamp": "2025-04-20T15:45:00.000Z", "updated_by": "marketing_manager_002", "fields_changed": ["discount_value", "usage_limits", "schedule.end_date"], "reason": "Extending promotion due to high customer engagement and positive ROI" }, { "timestamp": "2025-04-15T10:30:00.000Z", "updated_by": "marketing_admin_001", "fields_changed": ["display_settings.banner_text"], "reason": "Updated banner text for clarity" } ]}
Update Restrictions by Status
Draft Status
All fields can be freely modified
No restrictions on changes
Updates take effect immediately
Scheduled Status
Most fields can be updated
Start date can be modified if not within 24 hours
Promotion code cannot be changed
Active Status
Limited field updates allowed
Cannot decrease discount value or minimum purchase amounts
Cannot restrict eligibility criteria
Can extend end date and increase usage limits
Display settings can be updated
Paused Status
Same restrictions as active status
Can modify status to resume or deactivate
Schedule modifications allowed
Expired/Completed Status
No modifications allowed except for display settings
Updates primarily for archival and reporting purposes
Cannot reactivate expired promotions
Update Safety: The system prevents updates that could negatively impact customers who have already used the promotion or are in the process of using it.
Performance Optimization: When updating active promotions, monitor performance metrics closely to ensure changes have the desired effect on customer engagement and business objectives.
{ "error": "Invalid update for promotion status", "message": "Cannot decrease discount value for active promotion", "code": "INVALID_UPDATE_FOR_STATUS", "current_status": "active", "rejected_field": "discount_rules.discount_value"}
Validation Failure
Copy
{ "error": "Validation failed", "message": "End date must be after start date", "code": "VALIDATION_FAILED", "field": "schedule.end_date"}
Usage Limit Conflict
Copy
{ "error": "Usage limit conflict", "message": "Cannot set total usage limit below current usage count", "code": "USAGE_LIMIT_CONFLICT", "current_usage": 247, "requested_limit": 200}
Promotion Not Found
Copy
{ "error": "Promotion not found", "message": "The specified promotion does not exist", "code": "PROMOTION_NOT_FOUND"}
Customer Impact: Updates to active promotions may affect customer experience. Consider the timing of updates and communicate significant changes to customers when appropriate.
