> ## 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 for a subscription contract > Updates the custom attributes for a specific line item within a subscription contract. This endpoint accepts a contract ID, a line item ID, and a list of attribute objects (each containing key/value pairs) to update. It uses the underlying service to perform validation (such as contract existence, freeze status, and attribute-based cycle limits) before applying the update. The operation is intended for external API consumers, and authentication is performed via the X-API-Key header. Deprecated api_key parameter is supported for backward compatibility. ## OpenAPI ````yaml /subscription/admin-api-swagger.json put /api/external/v2/subscription-contracts-update-line-item-attributes openapi: 3.0.1 info: description: >- Comprehensive API documentation for managing subscriptions, payments, and related operations. These APIs allow you to programmatically manage subscription lifecycles, handle payments, configure products, and integrate subscription functionality into your applications. title: Admin APIs version: 0.0.1 servers: - url: https://subscription-admin.appstle.com security: [] tags: - description: >- Core APIs for managing the complete subscription lifecycle including creation, updates, pausing, resuming, and cancellation of subscriptions. name: Subscription Management - description: >- APIs for managing subscription payment methods, processing payments, handling payment retries, and updating billing information. name: Subscription Payments - description: >- APIs for managing subscription contracts including delivery schedules, pricing, order notes, billing cycles, and shipping addresses. name: Subscription Contracts - description: >- APIs for managing products within subscriptions including adding, removing, updating quantities, and swapping products. name: Subscription Products - description: >- APIs for handling billing operations, payment processing, and financial transactions related to subscriptions. name: Billing & Payments - description: >- APIs for managing discounts and promotional codes applied to subscriptions. name: Subscription Discounts - description: >- APIs for managing one-time add-on products that can be purchased alongside recurring subscription items. name: Subscription One-Time Products - description: >- APIs for managing subscription plans, pricing tiers, and plan configurations. name: Subscription Plans - description: >- APIs for managing customizable product boxes and bundles where customers can select multiple items. name: Build-a-Box & Bundles - description: >- APIs for managing the product catalog including product information, variants, and inventory. name: Product Catalog - description: >- APIs for managing operational settings, configurations, and administrative functions. name: Operations & Settings - description: >- APIs powering the customer-facing portal where subscribers can manage their own subscriptions. name: Customer Portal - description: APIs for managing customer information, profiles, and account details. name: Customers - description: >- APIs for retrieving aggregated subscription data, customer subscription history, and account-level subscription information. name: Subscription Data - description: >- APIs for managing delivery profiles, shipping rates, free shipping configuration, and delivery method options on subscriptions. name: Delivery & Shipping - description: >- APIs for managing storefront customization including custom CSS, theme settings, label translations, and merchant-defined widget configuration. name: Customization - description: >- APIs for configuring cancellation flows, retention offers, cancellation reason management, and win-back automation. name: Customer Retention paths: /api/external/v2/subscription-contracts-update-line-item-attributes: put: tags: - Subscription Contracts summary: Update line item attributes for a subscription contract description: >- Updates the custom attributes for a specific line item within a subscription contract. This endpoint accepts a contract ID, a line item ID, and a list of attribute objects (each containing key/value pairs) to update. It uses the underlying service to perform validation (such as contract existence, freeze status, and attribute-based cycle limits) before applying the update. The operation is intended for external API consumers, and authentication is performed via the X-API-Key header. Deprecated api_key parameter is supported for backward compatibility. operationId: updateLineItemAttributesV2 parameters: - description: The unique identifier of the subscription contract example: 123456789 in: query name: contractId required: true schema: format: int64 type: integer - deprecated: true description: 'Deprecated: API key (use X-API-Key header instead)' in: query name: api_key required: false schema: type: string - description: API Key for authentication in: header name: X-API-Key required: true schema: type: string - description: The unique identifier of the line item to update example: gid://shopify/SubscriptionLineItem/987654321 in: query name: lineId required: true schema: type: string requestBody: content: application/json: schema: description: A list of attribute objects containing keys and their new values items: $ref: '#/components/schemas/AttributeInfo' type: array required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SubscriptionContract' description: Line item attributes updated successfully '400': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: Invalid contract ID, line item ID, or attribute values '401': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: Authentication required '403': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: Insufficient permissions to update the subscription '404': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: Subscription contract or line item not found '422': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionContract' description: >- Unable to update the line item attributes due to subscription constraints 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 ````