POST /attached_items/{attached-item-id}

The device from which the customer has made the request

Default value: "application/x-www-form-urlencoded"

skip only webhooks

Valid values:

• "all-disabled"

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

skip all actions to be done on the events

Valid values:

• "all-disabled"

The email address of your customer/user. Use this when the email address has only ASCII characters.

The IP address of the customer where the request originated

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

skip only emails

Valid values:

• "all-disabled"

The id of the parent item in the attachment relationship.

Indicates when the item is charged. This parameter only applies to charge-items.

• contract_termination - when a contract term is terminated.
• subscription_creation - the time of creation of the subscription.
• subscription_trial_start - the time when the trial period of the subscription begins.
• on_demand - Item can be charged on demand
• 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.

Valid values:

• "subscription_activation"
• "plan_activation"
• "subscription_creation"
• "contract_termination"
• "subscription_trial_start"
• "on_demand"

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.

The default quantity of the addon to be attached when the quantity is not specified while creating/updating the subscription.

The decimal representation of the quantity of the addon. Returned for quantity-based addons when multi-decimal pricing is enabled.

The type of attachment for the addon. Only applicable for addon-items and is a required parameter as well for addon-items.

• recommended - The addon is recommended to go with the plan-item when using Checkout or Portal.
• 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.
• mandatory - The addon is attached automatically to the subscription for the plan-item unless explicitly removed via API.

Valid values:

• "optional"
• "recommended"
• "mandatory"

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 to be enabled for the site.The value set explicitly for billing_cycles while applying the addon to a subscription takes precedence over this parameter. This parameter, in turn, has a higher precedence than the value set for the addon-item price.