www/apps/resources/references/promotion/interfaces/promotion.UpdatePromotionDTO/page.mdx
import { TypeList } from "docs-ui"
The attributes to update in the promotion.
<TypeList types={[{"name":"id","type":"string","description":"The ID of the promotion.","optional":false,"defaultValue":"","expandable":false,"children":[]},{"name":"is_automatic","type":"boolean","description":"Whether the promotion is applied automatically.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"code","type":"string","description":"The code of the promotion.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"type","type":"PromotionTypeValues","description":"The type of the promotion.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"is_tax_inclusive","type":"boolean","description":"Whether the promotion is tax inclusive.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"limit","type":"null \| number","description":"The maximum number of times this promotion can be used.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"status","type":"PromotionStatusValues","description":"The status of the promotion:\n\n- draft indicates that a promotion is currently being prepared\n- active indicates that a promotion is active\n- inactive indicates that a promotion is no longer active","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"application_method","type":"Omit<UpdateApplicationMethodDTO, "id">","description":"The associated application method.","optional":true,"defaultValue":"","expandable":false,"children":[{"name":"type","type":"ApplicationMethodTypeValues","description":"The type of the application method indicating how\nthe associated promotion is applied.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"target_type","type":"ApplicationMethodTargetTypeValues","description":"The target type of the application method indicating\nwhether the associated promotion is applied to the cart's items,\nshipping methods, or the whole order.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"allocation","type":"ApplicationMethodAllocationValues","description":"The allocation value that indicates whether the associated promotion\nis applied on each item in a cart or split between the items in the cart.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"value","type":"number","description":"The discounted amount applied by the associated promotion based on the type.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"currency_code","type":"string","description":"The currency code of the promotions application","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"max_quantity","type":"null \| number","description":"The max quantity allowed in the cart for the associated promotion to be applied.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"buy_rules_min_quantity","type":"null \| number","description":"The minimum quantity required for a buyget promotion to be applied.\nFor example, if the promotion is a "Buy 2 shirts get 1 free", the\nvalue of this attribute is 2.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"apply_to_quantity","type":"null \| number","description":"The quantity that results from matching the buyget promotion's condition.\nFor example, if the promotion is a "Buy 2 shirts get 1 free", the value\nof this attribute is 1.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"promotion","type":"string \| PromotionDTO","description":"The promotion of the application method.","optional":true,"defaultValue":"","expandable":false,"children":[{"name":"id","type":"string","description":"The ID of the promotion.","optional":false,"defaultValue":"","expandable":false,"children":[]},{"name":"code","type":"string","description":"The code of the promotion.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"type","type":"PromotionTypeValues","description":"The type of the promotion:\n\n- standard indicates that a promotion is a standard one applied with conditions.\n- buyget indicates that a promotion is a "Buy X get Y" promotion.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"status","type":"PromotionStatusValues","description":"The status of the promotion:\n\n- active promotion is available for user to consume\n- inactive promotion is no longer available to the user\n- draft promotion is currently being prepared","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"is_automatic","type":"boolean","description":"Whether the promotion is applied automatically.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"is_tax_inclusive","type":"boolean","description":"Whether the promotion is tax inclusive.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"limit","type":"null \| number","description":"The maximum number of times this promotion can be used across all orders.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"used","type":"number","description":"The number of times this promotion has been used in completed orders.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"application_method","type":"ApplicationMethodDTO","description":"The associated application method.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"rules","type":"PromotionRuleDTO[]","description":"The rules of the promotion.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"campaign_id","type":"null \| string","description":"The associated campaign.","optional":true,"defaultValue":"","expandable":false,"children":[]},{"name":"campaign","type":"CampaignDTO","description":"The associated campaign.","optional":true,"defaultValue":"","expandable":false,"children":[]}]}]},{"name":"campaign_id","type":"null \| string","description":"The associated campaign's ID.","optional":true,"defaultValue":"","expandable":false,"children":[]}]} expandUrl="https://docs.medusajs.com/learn/fundamentals/data-models/manage-relationships#retrieve-records-of-relation" sectionTitle="UpdatePromotionDTO"/>