> ## 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. # Remove products or variants from ALL subscription groups > Removes specified products and/or variants from ALL subscription groups in the store. This is a powerful bulk operation that affects every subscription group simultaneously. **⚠️ WARNING:** This operation: - Affects ALL subscription groups in your store - Cannot be easily undone - Processes synchronously (may timeout for stores with many groups) - Does NOT affect existing active subscriptions **Use Cases:** - Discontinuing products from all subscription offerings - Removing seasonal items from all groups - Cleaning up deleted products from subscription groups - Compliance-driven product removals **Important Considerations:** - Each group is updated individually - If any group update fails, previous groups remain updated - Large operations may take significant time - Consider using individual group removal for better control **Authentication:** Requires valid X-API-Key header ## OpenAPI ````yaml /subscription/admin-api-swagger.json put /api/external/v2/subscription-groups/remove-products 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-groups/remove-products: put: tags: - Subscription Plans summary: Remove products or variants from ALL subscription groups description: >- Removes specified products and/or variants from ALL subscription groups in the store. This is a powerful bulk operation that affects every subscription group simultaneously. **⚠️ WARNING:** This operation: - Affects ALL subscription groups in your store - Cannot be easily undone - Processes synchronously (may timeout for stores with many groups) - Does NOT affect existing active subscriptions **Use Cases:** - Discontinuing products from all subscription offerings - Removing seasonal items from all groups - Cleaning up deleted products from subscription groups - Compliance-driven product removals **Important Considerations:** - Each group is updated individually - If any group update fails, previous groups remain updated - Large operations may take significant time - Consider using individual group removal for better control **Authentication:** Requires valid X-API-Key header operationId: deleteProductsOrVariantsInAllSubscriptionGroupPlan parameters: - description: >- Comma-separated list of product IDs to remove from all groups. Use numeric IDs without gid:// prefix. example: 987654321,987654322 in: query name: productIds required: false schema: pattern: ^\d+(,\d+)*$ type: string - description: >- Comma-separated list of variant IDs to remove from all groups. Use numeric IDs without gid:// prefix. example: 123456789,123456790 in: query name: variantIds required: false schema: pattern: ^\d+(,\d+)*$ type: string - deprecated: true description: API Key (Deprecated - Use X-API-Key header instead) in: query name: api_key required: false schema: type: string - description: API Key for authentication example: sk_live_1234567890abcdef in: header name: X-API-Key required: true schema: type: string responses: '200': content: application/json: example: Product Deleted Successfully schema: type: string description: Products/variants successfully removed from all subscription groups '400': content: application/json: examples: No Products or Variants Provided: description: No Products or Variants Provided value: detail: >- At least one of the Product Id(s) or Variant Id(s) is required status: 400 title: Bad Request type: https://example.com/errors/bad-request description: Invalid request parameters '401': content: '*/*': schema: type: string description: Authentication required - missing or invalid API key '403': content: '*/*': schema: type: string description: Insufficient permissions to modify subscription groups '500': content: application/json: example: detail: >- Error processing some subscription groups. Partial updates may have occurred. status: 500 title: Internal Server Error type: https://example.com/errors/internal-server-error description: Internal server error - some groups may have been updated ````