> ## 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. # Bulk update subscription delivery method > Updates the delivery method configuration for subscription contracts in bulk. **Endpoint:** `PUT /api/external/v2/bulk-automations/delivery-method` **Authentication:** - API Key (query parameter: api_key) **Query Parameters:** - `api_key` (required) – Your API key - `deliveryMethodTitle` (required) – Delivery method title - `deliveryMethodCode` (required) – Delivery method code - `deliveryMethodPresentmentTitle` (required) – Customer-facing delivery method title - `deliveryMethodId` (required) – Shopify Delivery Method Definition GraphQL ID **Request Body:** ```json { "subscriptionIds": "29879894300" } ``` **What This Endpoint Does:** - Updates the delivery method details for the provided subscription contracts - Creates a bulk automation task - Processes updates asynchronously in the background **How It Works:** 1. Merchant provides delivery method details via query parameters 2. Subscription IDs are provided in request body 3. System validates shop ownership and active status 4. Bulk automation job is created 5. Delivery method is updated for each subscription **Important Notes:** - Only one bulk automation per shop can run at a time - deliveryMethodId must be in Shopify GraphQL ID format (e.g. gid://shopify/DeliveryMethodDefinition/...) - Processing is asynchronous - Previous generated orders are not modified ## OpenAPI ````yaml /subscription/admin-api-swagger.json put /api/external/v2/bulk-automations/delivery-method 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/bulk-automations/delivery-method: put: tags: - Operations & Settings summary: Bulk update subscription delivery method description: >- Updates the delivery method configuration for subscription contracts in bulk. **Endpoint:** `PUT /api/external/v2/bulk-automations/delivery-method` **Authentication:** - API Key (query parameter: api_key) **Query Parameters:** - `api_key` (required) – Your API key - `deliveryMethodTitle` (required) – Delivery method title - `deliveryMethodCode` (required) – Delivery method code - `deliveryMethodPresentmentTitle` (required) – Customer-facing delivery method title - `deliveryMethodId` (required) – Shopify Delivery Method Definition GraphQL ID **Request Body:** ```json { "subscriptionIds": "29879894300" } ``` **What This Endpoint Does:** - Updates the delivery method details for the provided subscription contracts - Creates a bulk automation task - Processes updates asynchronously in the background **How It Works:** 1. Merchant provides delivery method details via query parameters 2. Subscription IDs are provided in request body 3. System validates shop ownership and active status 4. Bulk automation job is created 5. Delivery method is updated for each subscription **Important Notes:** - Only one bulk automation per shop can run at a time - deliveryMethodId must be in Shopify GraphQL ID format (e.g. gid://shopify/DeliveryMethodDefinition/...) - Processing is asynchronous - Previous generated orders are not modified operationId: updateDeliveryMethod_1 parameters: - description: Your API Key in: query name: api_key required: true schema: type: string - in: query name: deliveryMethodTitle required: true schema: type: string - in: query name: deliveryMethodCode required: true schema: type: string - in: query name: deliveryMethodPresentmentTitle required: true schema: type: string - in: query name: deliveryMethodId required: true schema: type: string - in: query name: suppressEmailNotification required: false schema: type: boolean - in: query name: allSubscriptions required: false schema: type: boolean requestBody: content: application/json: schema: $ref: '#/components/schemas/SubscriptionContractIdsWrapper' required: true responses: '204': content: application/json: example: {} description: Bulk delivery method update successfully queued and initiated. '400': description: >- Bad request - bulk operation already in progress or invalid parameters '401': description: Authentication required '403': description: Insufficient permissions '500': description: Internal server error during bulk operation initialization components: schemas: SubscriptionContractIdsWrapper: properties: subscriptionIds: type: string type: object ````