# Update an attached item > For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt). [Idempotency Supported](/docs/api/idempotency) Updates an attached addon or a charge item for a plan. ## Sample Request #### cURL ```bash curl https://{site}.chargebee.com/api/v2/attached_items/85943f11-6014-4ab5-990d-60c86a9c2893 \ -u {site_api_key}:\ -d parent_item_id="cb-demo" \ -d type="RECOMMENDED" ``` #### .NET ```dotnet using ChargeBee.Api; using ChargeBee.Models; ApiConfig.Configure("{site}","{site_api_key}"); EntityResult result = AttachedItem.Update("85943f11-6014-4ab5-990d-60c86a9c2893") .ParentItemId("cb-demo") .Type(AttachedItem.TypeEnum.Recommended) .Request(); AttachedItem attachedItem = result.AttachedItem; ``` #### Go ```go package main import ( "fmt" "github.com/chargebee/chargebee-go/v3" attacheditemAction "github.com/chargebee/chargebee-go/v3/actions/attacheditem" "github.com/chargebee/chargebee-go/v3/models/attacheditem" attachedItemEnum "github.com/chargebee/chargebee-go/v3/models/attacheditem/enum" ) func main() { chargebee.Configure("{site_api_key}","{site}"); res,err := attacheditemAction.Update("85943f11-6014-4ab5-990d-60c86a9c2893", &attacheditem.UpdateRequestParams{ ParentItemId : "cb-demo", Type : attachedItemEnum.TypeRecommended, }).Request() if err != nil { fmt.Println(err) } else { AttachedItem := res.AttachedItem } } ``` #### Go ```go package main import ( "fmt" "github.com/chargebee/chargebee-go/v4" ) func main() { config := &chargebee.ClientConfig{ SiteName: "{site}", ApiKey: "{site_api_key}", } client := chargebee.NewClient(config) req := &chargebee.AttachedItemUpdateRequest{ ParentItemId : "cb-demo", Type : chargebee.AttachedItemTypeRecommended, } res, err := client.AttachedItem.Update("85943f11-6014-4ab5-990d-60c86a9c2893", req) if err != nil { fmt.Println(err) } else { AttachedItem := res.AttachedItem } } ``` #### Java ```java import com.chargebee.*; import com.chargebee.ListResult; import com.chargebee.models.*; import com.chargebee.models.enums.*; import java.io.IOException; public class Sample { public static void main(String args[]) throws IOException, Exception { Environment.configure("{site}", "{site_api_key}"); Result result = AttachedItem.update("85943f11-6014-4ab5-990d-60c86a9c2893") .parentItemId("cb-demo") .type(AttachedItem.Type.RECOMMENDED) .request(); AttachedItem attachedItem = result.attachedItem(); } } ``` #### Java ```java import com.chargebee.v4.client.ChargebeeClient; import com.chargebee.v4.models.attachedItem.AttachedItem; import com.chargebee.v4.models.attachedItem.params.AttachedItemUpdateParams; import com.chargebee.v4.models.attachedItem.responses.AttachedItemUpdateResponse; public class AttachedItemUpdate { public static void main(String[] args) { ChargebeeClient client = ChargebeeClient.builder() .apiKey("{site_api_key}") .siteName("{site}") .build(); AttachedItemUpdateParams params = AttachedItemUpdateParams.builder() .parentItemId("cb-demo") .type(AttachedItemUpdateParams.Type.RECOMMENDED) .build(); AttachedItemUpdateResponse response = client .attachedItems() .update("85943f11-6014-4ab5-990d-60c86a9c2893", params); AttachedItem attachedItem = response.getAttachedItem(); } } ``` #### Node.js ```node import Chargebee from "chargebee"; const chargebee = new Chargebee({ site: "{site}", apiKey: "{site_api_key}", }); try { const result = await chargebee.attachedItem.update("85943f11-6014-4ab5-990d-60c86a9c2893", { parent_item_id: "cb-demo", type: "recommended" }); console.log(result); const attachedItem = result.attached_item; } catch (err) { console.log(err); } ``` #### PHP ```php "{site}", "apiKey" => "{site_api_key}", ]); $result = $chargebee->attachedItem()->update("85943f11-6014-4ab5-990d-60c86a9c2893", [ "parent_item_id" => "cb-demo", "type" => "recommended" ]); $attachedItem = $result->attached_item; ``` #### Python ```python import chargebee from chargebee import Chargebee cb_client = Chargebee(api_key="{site_api_key}", site="{site}") response = cb_client.AttachedItem.update("85943f11-6014-4ab5-990d-60c86a9c2893", cb_client.AttachedItem.UpdateParams( parent_item_id="cb-demo", type=chargebee.AttachedItem.Type.RECOMMENDED ) ) attached_item = response.attached_item ``` #### Ruby ```ruby require 'chargebee' ChargeBee.configure(:site => "{site}", :api_key => "{site_api_key}") result = ChargeBee::AttachedItem.update("85943f11-6014-4ab5-990d-60c86a9c2893",{ :parent_item_id => "cb-demo", :type => "RECOMMENDED" }) attached_item = result.attached_item ``` ## Sample Response ```json { "attached_item": { "created_at": 1594107090, "id": "85943f11-6014-4ab5-990d-60c86a9c2893", "item_id": "day-pass", "object": "attached_item", "parent_item_id": "cb-demo", "quantity": 1, "resource_version": 1594107092592, "status": "active", "type": "recommended", "updated_at": 1594107092 } } ``` ## URL Format **POST** https://[site].chargebee.com/api/v2/attached_items/{attached-item-id} ## Input Parameters - `parent_item_id` (required, string, max chars=100) The id of the parent item in the attachment relationship. - `type` (optional, enumerated string) The type of attachment for the addon. Only applicable for addon-items and is a required parameter as well for addon-items. Possible enum values: - `recommended` The addon is recommended to go with the plan-item when using [Checkout](https://www.chargebee.com/docs/2.0/configure-inapp.html#fundamental-settings_recommending-addons-in-checkout) or [Portal](https://www.chargebee.com/docs/2.0/inapp-self-serve-portal.html#allow-change-subscription) . - `mandatory` The addon is attached automatically to the subscription for the plan-item unless [explicitly removed](/docs/api/subscriptions) via API. - `optional` The addon is neither mandatory, nor recommended. This allows you to attach an addon so you can specify a `quantity` and `billing_cycles` for the addon, for when it is applied to subscriptions with the plan. - `billing_cycles` (optional, integer, min=1) The number of subscription billing cycles for which this item is attached when applied to a subscription. Applicable only for items of type addon. Requires [addon billing cycles](https://www.chargebee.com/docs/2.0/addons-billingcycle.html) to be enabled for the site. The value set explicitly for `billing_cycles` while [applying the addon to a subscription](/docs/api/subscriptions/subscription-object#subscription_items) takes precedence over this parameter. This parameter, in turn, has a higher precedence than [the value set for the addon-item price](/docs/api/item_prices) . - `quantity` (optional, integer, min=1) The default quantity of the addon to be attached when the quantity is not specified while [creating](/docs/api/subscriptions/create-subscription-for-items) /[updating](/docs/api/subscriptions/update-subscription-for-items) the subscription. - `quantity_in_decimal` (optional, string, max chars=33) The decimal representation of the quantity of the addon. Returned for quantity-based addons when [multi-decimal pricing](/docs/api/getting-started) is enabled. - `charge_on_event` (optional, enumerated string) Indicates when the item is charged. This parameter only applies to charge-items. Possible enum values: - `subscription_creation` the time of creation of the subscription. - `subscription_trial_start` the time when the trial period of the subscription begins. - `plan_activation` same as subscription activation, but also includes the case when the plan-item of the subscription is changed. - `subscription_activation` the moment a subscription enters an `active` or `non-renewing` state. Also includes reactivations of canceled subscriptions. - `contract_termination` when a contract term is [terminated](/docs/api/subscriptions/cancel-subscription-for-items#contract_term_cancel_option) . - `on_demand` Item can be charged on demand - `charge_once` (optional, boolean) Indicates if the charge-item is to be charged only once or each time the `charge_on_event` occurs. This parameter only applies to charge-items. ## Returns - `attached_item` (Attached item object) Resource object representing attached\_item