Updates an existing Build-A-Box subscription bundle with new configuration settings, product selections, pricing rules, or other bundle attributes. This endpoint allows you to modify any aspect of a previously created bundle while maintaining its unique identifier and shop association.
What Can Be Updated:
Update Behavior:
Impact on Active Subscriptions:
Common Update Scenarios:
Best Practices:
Validation Rules:
Authentication: Requires valid X-API-Key header or api_key parameter (deprecated)
curl --request PUT \
--url https://subscription-admin.appstle.com/api/external/v2/build-a-box \
--header 'Content-Type: application/json' \
--data '
{
"shop": "<string>"
}
'{
"id": 45678,
"shop": "example-shop.myshopify.com",
"bundleName": "Premium Coffee Selection - Updated",
"bundleHandle": "premium-coffee-selection",
"uniqueRef": "bab_abc123xyz",
"description": "Choose from our expanded selection of artisan coffee blends",
"buildABoxType": "SINGLE_PRODUCT",
"buildBoxVersion": "V2",
"minProductCount": 3,
"maxProductCount": 6,
"pricingType": "PER_PRODUCT",
"discount": 15,
"discountType": "PERCENTAGE",
"allowOneTimePurchase": true,
"active": true,
"availableProducts": [
{
"productId": 111111,
"variantId": 222222,
"title": "Medium Roast Coffee - 12oz",
"price": "14.99"
},
{
"productId": 111111,
"variantId": 333333,
"title": "Dark Roast Coffee - 12oz",
"price": "15.99"
},
{
"productId": 111111,
"variantId": 444444,
"title": "Espresso Roast Coffee - 12oz",
"price": "16.99"
}
],
"frequencies": [
{
"interval": "MONTH",
"intervalCount": 1,
"displayName": "Monthly"
},
{
"interval": "WEEK",
"intervalCount": 2,
"displayName": "Bi-Weekly"
}
],
"createdAt": "2024-03-15T10:30:00Z",
"updatedAt": "2024-03-20T14:45:00Z"
}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.
API Key (Deprecated - Use Header X-API-Key instead)
CART, CHECKOUT, CUSTOM, NONE QUICK_ADD, VIEW_DETAILS CLASSIC, SINGLE_PRODUCT, MIX_AND_MATCH, INFINITE, CUSTOMIZE_BUNDLE, CLASSIC_BUILD_A_BOX, SINGLE_PRODUCT_BUILD_A_BOX, VOLUME_DISCOUNT, DISCOUNTED_PRICING, SHIPPING_DISCOUNT, BUY_X_GET_Y, SECTIONED_BUNDLE FIXED, FLEXIBLE PRODUCT, COLLECTION, BOTH, ONE_TIME, SUBSCRIPTION SELECTED_PRODUCT, EACH_PRODUCT PRODUCT, COLLECTION Build-A-Box subscription bundle successfully updated
CART, CHECKOUT, CUSTOM, NONE QUICK_ADD, VIEW_DETAILS CLASSIC, SINGLE_PRODUCT, MIX_AND_MATCH, INFINITE, CUSTOMIZE_BUNDLE, CLASSIC_BUILD_A_BOX, SINGLE_PRODUCT_BUILD_A_BOX, VOLUME_DISCOUNT, DISCOUNTED_PRICING, SHIPPING_DISCOUNT, BUY_X_GET_Y, SECTIONED_BUNDLE FIXED, FLEXIBLE PRODUCT, COLLECTION, BOTH, ONE_TIME, SUBSCRIPTION SELECTED_PRODUCT, EACH_PRODUCT PRODUCT, COLLECTION curl --request PUT \
--url https://subscription-admin.appstle.com/api/external/v2/build-a-box \
--header 'Content-Type: application/json' \
--data '
{
"shop": "<string>"
}
'{
"id": 45678,
"shop": "example-shop.myshopify.com",
"bundleName": "Premium Coffee Selection - Updated",
"bundleHandle": "premium-coffee-selection",
"uniqueRef": "bab_abc123xyz",
"description": "Choose from our expanded selection of artisan coffee blends",
"buildABoxType": "SINGLE_PRODUCT",
"buildBoxVersion": "V2",
"minProductCount": 3,
"maxProductCount": 6,
"pricingType": "PER_PRODUCT",
"discount": 15,
"discountType": "PERCENTAGE",
"allowOneTimePurchase": true,
"active": true,
"availableProducts": [
{
"productId": 111111,
"variantId": 222222,
"title": "Medium Roast Coffee - 12oz",
"price": "14.99"
},
{
"productId": 111111,
"variantId": 333333,
"title": "Dark Roast Coffee - 12oz",
"price": "15.99"
},
{
"productId": 111111,
"variantId": 444444,
"title": "Espresso Roast Coffee - 12oz",
"price": "16.99"
}
],
"frequencies": [
{
"interval": "MONTH",
"intervalCount": 1,
"displayName": "Monthly"
},
{
"interval": "WEEK",
"intervalCount": 2,
"displayName": "Bi-Weekly"
}
],
"createdAt": "2024-03-15T10:30:00Z",
"updatedAt": "2024-03-20T14:45:00Z"
}