---
title: "PUT /api/subscriptions/{id}/items/{itemId}"
method: PUT
path: "/api/subscriptions/{id}/items/{itemId}"
tags: ["api"]
---

# PUT /api/subscriptions/{id}/items/{itemId}

`PUT /api/subscriptions/{id}/items/{itemId}`

Update Subscription Items

## Path parameters

- `id` string, required
- `itemId` string, required

## Request body

- PUTApiUpdateSubscriptionItems
  - `secret` string, required
  - `seatingReservationToken` string
  - `item` SubscriptionItemResource
    - `type` 'ticket' — The type of the cart item.
    - `_id` string — Unique identifier for the cart item. If omitted, the system will automatically generate one.
    - `name` string, nullable — The name of the cart item.
    - `amount` integer, required — The amount of the cart item.
    - `netPrice` number, float — The single piece net price of the cart item.
    - `price` number, float, required — The single piece price of the cart item.
    - `taxRate` number, float, nullable — The tax rate to be applied to this cart item. If not present the tax rate of the transaction is taken.
    - `triggeredBy` union — An ID or an array of IDs of other cart items which triggered the buy action of the cart item.
      - string — An ID of another cart item which triggered the buy action of the cart item.
      - string[] — An array of IDs of other cart items which triggered the buy action of the cart item.
    - `bundleInfo` object, nullable
      - `bundleId` string
      - `componentId` string
      - `optionId` string
    - `ticketTypeId` string, required — The ID of the ticket type of the cart item.
    - `categoryRef` string — The category reference of the ticket type.
    - `seatingInfo` object, nullable — The associated seating object.
      - `_id` string — The ID of the seating object.
      - `_type` 6 | 7, float, required — Indicates the type of seating object. Seat = 6, General Admission = 7.
      - `categoryId` string — The ID of the category containing the seating object.
      - `statusId` string, required — The ID of a container holding information about the seating status of the seating object.
      - `name` string, nullable — If _type == 7. The name of the general admission.
      - `seatType` 'handicapped' | 'limitedView' | 'foldable', nullable — If _type == 6. The type of the seat. null = normal.
      - `sectionName` string, nullable — If _type == 6. The name of the section where the seat is located.
      - `groupName` string, nullable — If _type == 6. The name of the row group where the seat is located.
      - `rowName` string, nullable — If _type == 6. The name of the row where the seat is located.
      - `seatName` string, nullable — If _type == 6. The seat name.
      - `gate` string, nullable — The entry gate associated with the seating object.
    - `slotInfo` object, nullable — The associated time slot object.
      - `slotId` string, required — The ID of the time slot.
      - `slotStartTime` string, required — The start time of the time slot.
    - `asHardTicket` boolean, nullable — Whether this ticket is a hard ticket.
    - `listingId` string, nullable — Listing in secondary market.
    - `listingItemId` string, nullable — The ID of the listing item in the secondary market.
    - `triggeredAutomations` boolean, nullable — Whether the cart item triggered automations.
    - `meta` object, nullable — Meta data which is propagated to the ticket.
    - `addOns` object[] — A list of Add-Ons of the ticket.
      - `productId` string, required
      - `productVariantId` string, required
      - `name` string, required
    - `capabilities` union[], nullable — The capabilities of the ticket.
      - union
        - object
          - `type` 'self_service_return', required
          - `settings` object, required
            - `returnRelatedItems` boolean
            - `phases` object[], required
              - …
        - object
          - `type` 'repersonalization', required
          - `settings` object, required
            - `inherit` boolean
            - `repersonalizationDeadline` object, required
              - …
            - `repersonalizationsLimit` number, float, nullable
            - `repersonalizationFee` number, float, nullable
            - `limitOnlyNameChanges` boolean
    - `taxInfo` object — The tax info details.
      - `serviceTypeId` string — The ID of the service type.
      - `exceptionId` string — The ID of the exception.
      - `proceedsAccountId` string — The ID of the proceeds account.
      - `proceedsAccountCode` string — The code of the proceeds account.
      - `taxItems` object[] — The array of tax items.
        - `name` string, nullable
        - `taxTypeId` string, nullable
        - `rate` number, float, required
        - `perUnit` number, float, required
        - `total` number, float, required
        - `netTotal` number, float, nullable
        - `netPerUnit` number, float, nullable
        - `taxPayableAccountId` string, nullable
        - `taxPayableAccountCode` string, nullable
    - `ticketId` string, required — The ticket ID of the item
    - `planVariantId` string — The plan variant ID of the item

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)