subscriptionDraftDiscountUpdate
mutation

Choose a version:

Requires write_own_subscription_contracts access scope. Also: The user must have manage_orders_information permission.

Updates a subscription discount on a subscription draft.

Anchor to section titled 'Arguments'

Arguments

Anchor to discountId discountId ID! required: The gid of the Subscription Discount to update.
Anchor to draftId draftId ID! required: The ID of the Subscription Contract draft to update a subscription discount on.
Anchor to input input SubscriptionManualDiscountInput! required: The properties to update on the Subscription Discount.

Was this section helpful?

Anchor to section titled 'SubscriptionDraftDiscountUpdatePayload returns'

SubscriptionDraftDiscountUpdatePayload returns

Anchor to SubscriptionDraftDiscountUpdatePayload.discountUpdated discountUpdated SubscriptionManualDiscount: The updated Subscription Discount.
Anchor to SubscriptionDraftDiscountUpdatePayload.draft draft SubscriptionDraft: The Subscription Contract draft object.
Anchor to SubscriptionDraftDiscountUpdatePayload.userErrors userErrors [SubscriptionDraftUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Code examples for MUTATION: subscriptionDraftDiscountUpdate

Query Reference for MUTATION: subscriptionDraftDiscountUpdate

"mutation subscriptionDraftDiscountUpdate($discountId: ID!, $draftId: ID!, $input: SubscriptionManualDiscountInput!) {\n  subscriptionDraftDiscountUpdate(discountId: $discountId, draftId: $draftId, input: $input) {\n    discountUpdated {\n      # SubscriptionManualDiscount fields\n    }\n    draft {\n      # SubscriptionDraft fields\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}"

Input Reference for MUTATION: subscriptionDraftDiscountUpdate

"{\n  \"discountId\": \"gid://shopify/<objectName>/10079785100\",\n  \"draftId\": \"gid://shopify/<objectName>/10079785100\",\n  \"input\": {\n    \"entitledLines\": {\n      \"all\": true,\n      \"lines\": {\n        \"add\": [\n          \"gid://shopify/<objectName>/10079785100\"\n        ],\n        \"remove\": [\n          \"gid://shopify/<objectName>/10079785100\"\n        ]\n      }\n    },\n    \"recurringCycleLimit\": 1,\n    \"title\": \"<your-title>\",\n    \"value\": {\n      \"fixedAmount\": {\n        \"amount\": 1.1,\n        \"appliesOnEachItem\": true\n      },\n      \"percentage\": 1\n    }\n  }\n}"

Schema Reference for MUTATION: subscriptionDraftDiscountUpdate

"input SubscriptionManualDiscountInput {\n  entitledLines: SubscriptionManualDiscountEntitledLinesInput\n  recurringCycleLimit: Int\n  title: String\n  value: SubscriptionManualDiscountValueInput\n}\n\ninput SubscriptionManualDiscountEntitledLinesInput {\n  all: Boolean\n  lines: SubscriptionManualDiscountLinesInput\n}\n\ninput SubscriptionManualDiscountValueInput {\n  fixedAmount: SubscriptionManualDiscountFixedAmountInput\n  percentage: Int\n}\n"

Display Examples for MUTATION: subscriptionDraftDiscountUpdate

[]

subscriptionDraftDiscountUpdatemutation

Arguments

SubscriptionDraftDiscountUpdatePayload returns

subscriptionDraftDiscountUpdate
mutation