Mutation

setCartVolumeQuantities

Sets ticket quantities for one general admission area of a seatmap, creating the cart if needed.

A SeatmapVolume is an area of a seatmap without individual seats, such as a standing room block. Its tickets are bought by quantity rather than by picking a seat, so this mutation is the seatmap equivalent of setCartItemQuantity. To add a specific seat instead, use addSeatToCart.

One call addresses exactly one area, identified by seatmapId and volumeId, and can set quantities for several ticket types of that area at once. Each CartVolumeQuantityInput.quantity is the desired absolute total for its CartVolumeQuantityInput.ticketTypeId in that area, not a delta; 0 removes all tickets of that ticket type from it. Ticket types you leave out of the list keep the quantity they already have, and other areas are never touched.

Leave the cartId field of SetCartVolumeQuantitiesInput out to start a new cart. The shop named by shopSlug (see Shop.slug) determines availability and pricing, and the new cart's ID is returned as Cart.id on SetCartVolumeQuantitiesPayload.cart. Passing the ID of a cart that does not exist or has already expired fails with an error.

Supply passwords for ticket types that are hidden behind one; without a match those ticket types are not visible to the call. The call fails with an error and leaves the cart completely unchanged when the requested totals exceed the remaining capacity of the area or the remaining availability of a ticket type, when a requested total is not one of the totals the ticket type allows, when a ticket type is not on sale right now or its ID does not name a seatmap ticket type, or when the request exceeds the number of tickets a single customer may buy for the event.