# Update Bundles
source: https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/bundle-operations/update_bundles/index.md

#### Overview {#overview}

**Actors:** Issuer developer, Mastercard Global Benefits Platform  

**Preconditions:** The specified bundle(s) are currently assigned to the card; the assignment has a future-dated or same-day effective date (past-dated effective dates cannot be modified)  

**Outcome:** The bundle's effective and/or expiry dates are updated; the benefit assignment remains active with the same bundle code  

**Endpoint:** `PUT /card-bundles-updates` --- use this endpoint to adjust the dates on an existing active or future-dated bundle; use [Replace Bundles](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/bundle-operations/replace_bundles/index.md) if the bundle code itself needs to change

Updates a bundle associated to the card for the input bundles. The response is an array of bundles that are updated on the card. The benefit allocation update bundle service can:
Diagram update_bundle
API Reference: `PUT /card-bundles-updates`

### Use Case 1: update bundle associated with a card {#use-case-1-update-bundle-associated-with-a-card}

1. Cardholder requests an existing benefit associated with their card be updated.
2. Issuer sends a request with a list of bundles to be updated on the PAN number, along with an effective date and an optional expiry date as input parameters.
3. Benefit Allocation Service API returns an array of bundles that are updated on the card which contains benefit bundle codes with their updated effective and expiry dates.

### Use Case 2: bundle with future effective date {#use-case-2-bundle-with-future-effective-date}

1. Cardholder requests an existing benefit associated with their card be updated.
2. Issuer sends a request with a list of bundles to be updated on the PAN number, along with a future effective date and an optional expiry date as input parameters.
3. Benefit Allocation Service API returns an array of bundles that are updated on the card which contains benefit bundle codes with their updated effective and expiry dates, bundle code with the future effective date will be applied with the future effective date.

### Use Case 3: bundle that has been expired in the past {#use-case-3-bundle-that-has-been-expired-in-the-past}

1. Cardholder requests an existing benefit associated with their card be updated.
2. Issuer sends a request with a list of bundles to be updated on the PAN number, along with an effective date and an optional expiry date as input parameters.
3. Benefit Allocation Service API returns an array of bundles that are updated on the card which contains benefit bundle codes with their updated effective and expiry dates, the expired bundle is not updated.

### Use Case 4: bundle with a future expiry date {#use-case-4-bundle-with-a-future-expiry-date}

1. Cardholder requests an existing benefit associated with their card be updated.
2. Issuer sends a request with a list of bundles to be updated on the PAN number, along with an effective date and an optional expiry date as input parameters.
3. Benefit Allocation Service API returns an array of bundles that are updated on the card which contains benefit bundle codes with their updated effective and expiry dates, future expiration dates will get the future expiration date applied.

## Additional Information {#additional-information}

1. Look at the [API Reference](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/api-reference/index.md) for information on how to implement this use case.
2. Look at the [Code and Formats](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/code-and-formats/index.md) for acknowledgement responses.