> ## Documentation Index > Fetch the complete documentation index at: https://developers.appstle.com/llms.txt > Use this file to discover all available pages before exploring further. # Update line item attributes > Updates custom attributes on a subscription contract line item from the customer portal. ## OpenAPI ````yaml /memberships/storefront-api-swagger.json put /memberships/cp/api/subscription-contracts-update-line-item-attributes openapi: 3.0.1 info: description: >- Comprehensive API documentation for the customer-facing membership portal. These APIs enable customers to manage their memberships, update billing information, modify delivery schedules, and access their account details through your storefront. **Important**: These APIs must be called from your shop's domain (e.g., https://www.myshop.com/apps/memberships/cp/api/**) and require customer authentication. Unauthenticated requests will return a 401 Unauthorized error. title: Storefront APIs version: 0.0.1 servers: - url: https://www.myshop.com/apps security: [] tags: - description: >- APIs for managing Shopify delivery profiles, shipping rates, zones, and free shipping configuration for subscription memberships name: Shipping & Delivery Profiles - description: >- APIs for managing shop-level membership settings, configuration, email domains, webhooks, and general store information name: Shop Settings - description: >- APIs for integrating loyalty programs with memberships including customer points lookup, earn options, redeem options, and point redemption name: Loyalty Integration - description: >- APIs for retrieving historical discount code usage and redemption information for membership contracts name: Customer Discount History - description: >- APIs for managing membership cancellation flow settings including retention offers, survey questions, and cancel confirmation screens name: Cancellation Flow Configuration - description: >- APIs for managing membership billing attempts, recurring orders, payment retries, order history, and order skipping name: Billing & Orders - description: >- APIs for managing one-time product additions to upcoming subscription orders, including adding, retrieving, and removing one-off items name: One-Time Add-Ons - description: >- APIs for managing membership/subscription plan groups, including creating plans, configuring discounts, billing intervals, and assigning products to plans name: Membership Plans - description: >- APIs for managing customer retention activities including cancellation feedback, retention action tracking, and activity export name: Customer Retention - description: >- APIs for retrieving custom CSS styles applied to subscription widgets and customer portal for theme customization name: Custom CSS Styling - description: >- APIs for managing customer portal settings including UI customization, text labels, feature toggles, and branding options for the member self-service portal name: Customer Portal Configuration - description: >- APIs for managing membership/subscription contracts including creation, updates, status changes, line items, discounts, and billing operations name: Membership Contracts - description: >- APIs for retrieving product catalog, variants, pricing, and inventory information for subscription memberships name: Product & Inventory Data - description: >- APIs for retrieving product swap/substitution options allowing members to exchange subscription items based on configured swap rules and variant groups name: Product Swap Rules - description: APIs for managing subscription product bundles and bundle configurations. name: Product Bundles - description: APIs for managing payment methods and billing information. name: Customer Payment Methods paths: /memberships/cp/api/subscription-contracts-update-line-item-attributes: put: tags: - Membership Contracts summary: Update line item attributes description: >- Updates custom attributes on a subscription contract line item from the customer portal. operationId: updateLineItemAttributes parameters: - in: query name: contractId required: true schema: format: int64 type: integer - in: query name: lineId required: true schema: type: string - in: query name: isExternal required: false schema: default: false type: boolean requestBody: content: application/json: schema: items: $ref: '#/components/schemas/AttributeInfo' type: array required: true responses: '200': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: OK components: schemas: AttributeInfo: properties: key: type: string value: type: string type: object SubscriptionContract: properties: billingAttempts: $ref: '#/components/schemas/BillingAttempts' billingPolicy: $ref: '#/components/schemas/BillingPolicy' createdAt: type: object customAttributes: items: $ref: '#/components/schemas/CustomAttribute1' type: array customer: $ref: '#/components/schemas/Customer' customerPaymentMethod: $ref: '#/components/schemas/CustomerPaymentMethod' deliveryMethod: $ref: '#/components/schemas/DeliveryMethod' deliveryPolicy: $ref: '#/components/schemas/DeliveryPolicy' deliveryPrice: $ref: '#/components/schemas/DeliveryPrice' discounts: $ref: '#/components/schemas/Discounts' get__typename: type: string id: type: string lastPaymentStatus: enum: - SUCCEEDED - FAILED - $UNKNOWN type: string lines: $ref: '#/components/schemas/Lines' nextBillingDate: type: object note: type: string originOrder: $ref: '#/components/schemas/OriginOrder' status: enum: - ACTIVE - PAUSED - CANCELLED - EXPIRED - FAILED - $UNKNOWN type: string updatedAt: type: object type: object BillingAttempts: properties: get__typename: type: string nodes: items: $ref: '#/components/schemas/Node3' type: array type: object BillingPolicy: properties: anchors: items: $ref: '#/components/schemas/Anchor' type: array get__typename: type: string interval: enum: - DAY - WEEK - MONTH - YEAR - $UNKNOWN type: string intervalCount: format: int32 type: integer maxCycles: format: int32 type: integer minCycles: format: int32 type: integer type: object CustomAttribute1: properties: get__typename: type: string key: type: string value: type: string type: object Customer: properties: displayName: type: string email: deprecated: true type: string firstName: type: string get__typename: type: string id: type: string lastName: type: string phone: deprecated: true type: string type: object CustomerPaymentMethod: properties: get__typename: type: string id: type: string instrument: $ref: '#/components/schemas/Instrument' revokedAt: type: object revokedReason: enum: - AUTHORIZE_NET_GATEWAY_NOT_ENABLED - AUTHORIZE_NET_RETURNED_NO_PAYMENT_METHOD - FAILED_TO_UPDATE_CREDIT_CARD - STRIPE_API_AUTHENTICATION_ERROR - STRIPE_API_INVALID_REQUEST_ERROR - STRIPE_GATEWAY_NOT_ENABLED - STRIPE_RETURNED_NO_PAYMENT_METHOD - STRIPE_PAYMENT_METHOD_NOT_CARD - BRAINTREE_API_AUTHENTICATION_ERROR - BRAINTREE_GATEWAY_NOT_ENABLED - BRAINTREE_RETURNED_NO_PAYMENT_METHOD - BRAINTREE_PAYMENT_METHOD_NOT_CARD - PAYMENT_METHOD_VERIFICATION_FAILED - THREE_D_SECURE_FLOW_IN_VERIFICATION_NOT_IMPLEMENTED - MANUALLY_REVOKED - FAILED_TO_RETRIEVE_BILLING_ADDRESS - MERGED - CUSTOMER_REDACTED - TOO_MANY_CONSECUTIVE_FAILURES - CVV_ATTEMPTS_LIMIT_EXCEEDED - $UNKNOWN type: string type: object DeliveryMethod: properties: get__typename: type: string type: object DeliveryPolicy: properties: anchors: items: $ref: '#/components/schemas/Anchor1' type: array get__typename: type: string interval: enum: - DAY - WEEK - MONTH - YEAR - $UNKNOWN type: string intervalCount: format: int32 type: integer type: object DeliveryPrice: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object Discounts: properties: get__typename: type: string nodes: items: $ref: '#/components/schemas/Node2' type: array pageInfo: $ref: '#/components/schemas/PageInfo2' type: object Lines: properties: get__typename: type: string nodes: items: $ref: '#/components/schemas/Node' type: array pageInfo: $ref: '#/components/schemas/PageInfo' type: object OriginOrder: properties: fulfillmentOrders: $ref: '#/components/schemas/FulfillmentOrders' get__typename: type: string id: type: string name: type: string type: object Node3: properties: completedAt: type: object createdAt: type: object get__typename: type: string id: type: string idempotencyKey: type: string ready: deprecated: true type: boolean type: object Anchor: properties: cutoffDay: format: int32 type: integer day: format: int32 type: integer get__typename: type: string month: format: int32 type: integer type: enum: - WEEKDAY - MONTHDAY - YEARDAY - $UNKNOWN type: string type: object Instrument: properties: get__typename: type: string type: object Anchor1: properties: cutoffDay: format: int32 type: integer day: format: int32 type: integer get__typename: type: string month: format: int32 type: integer type: enum: - WEEKDAY - MONTHDAY - YEARDAY - $UNKNOWN type: string type: object Node2: properties: get__typename: type: string id: type: string recurringCycleLimit: format: int32 type: integer rejectionReason: enum: - NOT_FOUND - NO_ENTITLED_LINE_ITEMS - QUANTITY_NOT_IN_RANGE - PURCHASE_NOT_IN_RANGE - CUSTOMER_NOT_ELIGIBLE - USAGE_LIMIT_REACHED - CUSTOMER_USAGE_LIMIT_REACHED - CURRENTLY_INACTIVE - NO_ENTITLED_SHIPPING_LINES - INCOMPATIBLE_PURCHASE_TYPE - INTERNAL_ERROR - $UNKNOWN type: string targetType: enum: - LINE_ITEM - SHIPPING_LINE - $UNKNOWN type: string title: type: string type: enum: - MANUAL - CODE_DISCOUNT - AUTOMATIC_DISCOUNT - $UNKNOWN type: string usageCount: format: int32 type: integer value: $ref: '#/components/schemas/Value' type: object PageInfo2: properties: endCursor: type: string get__typename: type: string hasNextPage: type: boolean hasPreviousPage: type: boolean startCursor: type: string type: object Node: properties: currentPrice: $ref: '#/components/schemas/CurrentPrice' customAttributes: items: $ref: '#/components/schemas/CustomAttribute' type: array discountAllocations: items: $ref: '#/components/schemas/DiscountAllocation' type: array get__typename: type: string id: type: string lineDiscountedPrice: $ref: '#/components/schemas/LineDiscountedPrice' pricingPolicy: $ref: '#/components/schemas/PricingPolicy' productId: type: string quantity: format: int32 type: integer sellingPlanId: type: string sellingPlanName: type: string sku: type: string taxable: type: boolean title: type: string variantId: type: string variantImage: $ref: '#/components/schemas/VariantImage' variantTitle: type: string type: object PageInfo: properties: endCursor: type: string get__typename: type: string hasNextPage: type: boolean hasPreviousPage: type: boolean startCursor: type: string type: object FulfillmentOrders: properties: get__typename: type: string nodes: items: $ref: '#/components/schemas/Node1' type: array pageInfo: $ref: '#/components/schemas/PageInfo1' type: object Value: properties: get__typename: type: string type: object CurrentPrice: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object CustomAttribute: properties: get__typename: type: string key: type: string value: type: string type: object DiscountAllocation: properties: amount: $ref: '#/components/schemas/Amount' discount: $ref: '#/components/schemas/Discount' get__typename: type: string type: object LineDiscountedPrice: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object PricingPolicy: properties: basePrice: $ref: '#/components/schemas/BasePrice' cycleDiscounts: items: $ref: '#/components/schemas/CycleDiscount' type: array get__typename: type: string type: object VariantImage: properties: get__typename: type: string url: type: object type: object Node1: properties: fulfillAt: type: object get__typename: type: string id: type: string status: enum: - OPEN - IN_PROGRESS - CANCELLED - INCOMPLETE - CLOSED - SCHEDULED - ON_HOLD - $UNKNOWN type: string type: object PageInfo1: properties: endCursor: type: string get__typename: type: string hasNextPage: type: boolean hasPreviousPage: type: boolean startCursor: type: string type: object Amount: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object Discount: properties: get__typename: type: string type: object BasePrice: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object CycleDiscount: properties: adjustmentType: enum: - PERCENTAGE - FIXED_AMOUNT - PRICE - $UNKNOWN type: string adjustmentValue: $ref: '#/components/schemas/AdjustmentValue' afterCycle: format: int32 type: integer computedPrice: $ref: '#/components/schemas/ComputedPrice' get__typename: type: string type: object AdjustmentValue: properties: get__typename: type: string type: object ComputedPrice: properties: amount: type: object currencyCode: enum: - USD - EUR - GBP - CAD - AFN - ALL - DZD - AOA - ARS - AMD - AWG - AUD - BBD - AZN - BDT - BSD - BHD - BIF - BYN - BZD - BMD - BTN - BAM - BRL - BOB - BWP - BND - BGN - MMK - KHR - CVE - KYD - XAF - CLP - CNY - COP - KMF - CDF - CRC - HRK - CZK - DKK - DJF - DOP - XCD - EGP - ERN - ETB - FKP - XPF - FJD - GIP - GMD - GHS - GTQ - GYD - GEL - GNF - HTG - HNL - HKD - HUF - ISK - INR - IDR - ILS - IRR - IQD - JMD - JPY - JEP - JOD - KZT - KES - KID - KWD - KGS - LAK - LVL - LBP - LSL - LRD - LYD - LTL - MGA - MKD - MOP - MWK - MVR - MRU - MXN - MYR - MUR - MDL - MAD - MNT - MZN - NAD - NPR - ANG - NZD - NIO - NGN - NOK - OMR - PAB - PKR - PGK - PYG - PEN - PHP - PLN - QAR - RON - RUB - RWF - WST - SHP - SAR - RSD - SCR - SLL - SGD - SDG - SOS - SYP - ZAR - KRW - SSP - SBD - LKR - SRD - SZL - SEK - CHF - TWD - THB - TJS - TZS - TOP - TTD - TND - TRY - TMT - UGX - UAH - AED - UYU - UZS - VUV - VES - VND - XOF - YER - ZMW - USDC - BYR - STD - STN - VED - VEF - XXX - $UNKNOWN type: string get__typename: type: string type: object ````