> ## 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.

# Replace all line item attributes in bulk across subscription contracts

> This API replaces all existing attributes for the specified line items within subscription contracts. Use carefully, as any attributes not included in the request will be removed.



## OpenAPI

````yaml /subscription/admin-api-swagger.json put /api/external/v2/subscription-contracts-bulk-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-bulk-update-line-item-attributes:
    put:
      tags:
        - Subscription Contracts
      summary: Replace all line item attributes in bulk across subscription contracts
      description: >-
        This API replaces all existing attributes for the specified line items
        within subscription contracts. Use carefully, as any attributes not
        included in the request will be removed.
      operationId: updateMultipleContractsLineItemAttributesV2
      parameters:
        - description: API Key for authentication
          in: header
          name: X-API-Key
          required: true
          schema:
            type: string
        - description: >-
            Optional comma-separated list of subscription contract IDs to
            update. Example: 32665403611,3266540311,326654036123. Ignored if
            allSubscriptions=true.
          in: query
          name: contractIds
          required: false
          schema:
            type: string
        - description: >-
            If true, updates all active subscriptions of the shop. If false
            (default), updates only the provided contractId or contractIds.
          in: query
          name: allSubscriptions
          required: false
          schema:
            default: false
            type: boolean
      requestBody:
        content:
          application/json:
            examples:
              Attributes Example:
                description: Attributes Example
                value:
                  - key: color
                    value: red
                  - key: size
                    value: M
            schema:
              items:
                $ref: '#/components/schemas/AttributeInfo'
              type: array
        description: >-
          A JSON array of attributes. ⚠️ Note: Providing this array will replace
          all existing attributes in the specified contract. Add or update
          attributes carefully, as any attributes not included in the request
          will be removed.
      responses:
        '200':
          content:
            '*/*':
              schema:
                type: string
          description: OK
components:
  schemas:
    AttributeInfo:
      properties:
        key:
          type: string
        value:
          type: string
      type: object

````