seatschart 0.1.1 → 0.2.0

data/lib/seatschart/api/object_status_api.rb

@@ -439,7 +439,7 @@ module SeatsChart
     end
 
     # Put booked objects up for resale
-    # Resale retains the durable owner and sold status. Optional `resaleListingId` groups the objects into one listing (extraData.resaleListingId). Optional `resalePriceCents` is stored on extraData and merged into GET /seats on the next cache rebuild. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 `ambiguous_label`; unknown references return 404 `objects_not_found`). General admission areas are addressed by UUID or name **with `quantity`** (1–10000): - `booked`: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then `sold_count` is incremented in the transaction with a `sold_count + quantity <= capacity` guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - `reservedByToken` (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (`hold: { holdToken, holdUserId, holdExpiresAt }`), confirmable with POST /ga/confirm (`holdToken`, `userId` = `holdUserId`). Optional `userId` (customer identity of the hold; one hold per user and area, 409 `hold_exists`) and `holdExpiresInMinutes` (1–120). 409 `insufficient_capacity`. - `RELEASE` / `free` without `holdToken`: releases places of **administrative** bookings (newest receipts first, optionally only those of `orderId`), recording a release receipt per consumed booking and decrementing `sold_count` under the GA row lock (409 `insufficient_booked_places` with `available`). Buyer purchases are never released here. - `RELEASE` with `holdToken` (GA hold token): releases that many places held by the token (409 `insufficient_held_places`, `hold_token_conflict`). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor `sold_count` go below zero. Response `gaAreas: { <areaId>: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }`.  **`allowedPreviousStatuses` / `rejectedPreviousStatuses`**: `free`, `booked`, `resale`, `reservedByToken`, `retired` or a custom status. On violation nothing is written and 409 `illegal_previous_status` lists every offending object with its current status. For GA quantities the previous status follows from the operation: `free` for book/hold, `booked` for a release, `reservedByToken` for a release by `holdToken`.  **`holdToken`**: with status `booked`, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 `hold_token_conflict`. Remaining seats of the session stay held. With `RELEASE` it releases GA places (see above).  **`ticketType`** (per object, `{ objectId, ticketType }`, status `booked` only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **`keepExtraData`**: keeps the stored extraData; per-object `extraData` sent with it is merged on top (without it, the object's extraData is replaced by the one sent, or cleared).  **`ticketBuyerId`** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId=….  **`channelKeys`** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 `channel_forbidden` otherwise). Without `channelKeys`, or with `ignoreChannels: true`, channel partitions are ignored (backward-compatible default).  **`events`** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with `results[]` (`{ eventId, ok, objects | status, error, message }`), `succeeded` and `failed`. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **`atomic: true`** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with `atomic: true` when everything was applied, otherwise the status of the first failing event and `results[]` with `outcome: failed` (with `error`, `message`) or `rolled_back` per event — nothing was written. GA administrative holds cannot be atomic (400 `not_atomic`).  **`seasonId`** (season or partial season id; XOR with `events`): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
+    # Resale retains the durable owner and sold status. Optional `resaleListingId` groups the objects into one listing (extraData.resaleListingId). Optional `resalePriceCents` is stored on extraData and merged into GET /seats on the next cache rebuild. Optional `listing` also creates a server-side listing of the objects (type, sellAsWhole, price; see the listings tag): viewers then show and sell it as one listing. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 `ambiguous_label`; unknown references return 404 `objects_not_found`). General admission areas are addressed by UUID or name **with `quantity`** (1–10000): - `booked`: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then `sold_count` is incremented in the transaction with a `sold_count + quantity <= capacity` guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - `reservedByToken` (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (`hold: { holdToken, holdUserId, holdExpiresAt }`), confirmable with POST /ga/confirm (`holdToken`, `userId` = `holdUserId`). Optional `userId` (customer identity of the hold; one hold per user and area, 409 `hold_exists`) and `holdExpiresInMinutes` (1–120). 409 `insufficient_capacity`. - `RELEASE` / `free` without `holdToken`: releases places of **administrative** bookings (newest receipts first, optionally only those of `orderId`), recording a release receipt per consumed booking and decrementing `sold_count` under the GA row lock (409 `insufficient_booked_places` with `available`). Buyer purchases are never released here. - `RELEASE` with `holdToken` (GA hold token): releases that many places held by the token (409 `insufficient_held_places`, `hold_token_conflict`). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor `sold_count` go below zero. Response `gaAreas: { <areaId>: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }`.  **`allowedPreviousStatuses` / `rejectedPreviousStatuses`**: `free`, `booked`, `resale`, `reservedByToken`, `retired` or a custom status. On violation nothing is written and 409 `illegal_previous_status` lists every offending object with its current status. For GA quantities the previous status follows from the operation: `free` for book/hold, `booked` for a release, `reservedByToken` for a release by `holdToken`.  **`holdToken`**: with status `booked`, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 `hold_token_conflict`. Remaining seats of the session stay held. With `RELEASE` it releases GA places (see above).  **`ticketType`** (per object, `{ objectId, ticketType }`, status `booked` only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **`keepExtraData`**: keeps the stored extraData; per-object `extraData` sent with it is merged on top (without it, the object's extraData is replaced by the one sent, or cleared).  **`ticketBuyerId`** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId=….  **`channelKeys`** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 `channel_forbidden` otherwise). Without `channelKeys`, or with `ignoreChannels: true`, channel partitions are ignored (backward-compatible default).  **`events`** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with `results[]` (`{ eventId, ok, objects | status, error, message }`), `succeeded` and `failed`. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **`atomic: true`** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with `atomic: true` when everything was applied, otherwise the status of the first failing event and `results[]` with `outcome: failed` (with `error`, `message`) or `rolled_back` per event — nothing was written. GA administrative holds cannot be atomic (400 `not_atomic`).  **`seasonId`** (season or partial season id; XOR with `events`): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
     # @param event_id [String] 
     # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
     # @param [Hash] opts the optional parameters
@@ -451,7 +451,7 @@ module SeatsChart
     end
 
     # Put booked objects up for resale
-    # Resale retains the durable owner and sold status. Optional &#x60;resaleListingId&#x60; groups the objects into one listing (extraData.resaleListingId). Optional &#x60;resalePriceCents&#x60; is stored on extraData and merged into GET /seats on the next cache rebuild. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 &#x60;ambiguous_label&#x60;; unknown references return 404 &#x60;objects_not_found&#x60;). General admission areas are addressed by UUID or name **with &#x60;quantity&#x60;** (1–10000): - &#x60;booked&#x60;: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then &#x60;sold_count&#x60; is incremented in the transaction with a &#x60;sold_count + quantity &lt;&#x3D; capacity&#x60; guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - &#x60;reservedByToken&#x60; (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (&#x60;hold: { holdToken, holdUserId, holdExpiresAt }&#x60;), confirmable with POST /ga/confirm (&#x60;holdToken&#x60;, &#x60;userId&#x60; &#x3D; &#x60;holdUserId&#x60;). Optional &#x60;userId&#x60; (customer identity of the hold; one hold per user and area, 409 &#x60;hold_exists&#x60;) and &#x60;holdExpiresInMinutes&#x60; (1–120). 409 &#x60;insufficient_capacity&#x60;. - &#x60;RELEASE&#x60; / &#x60;free&#x60; without &#x60;holdToken&#x60;: releases places of **administrative** bookings (newest receipts first, optionally only those of &#x60;orderId&#x60;), recording a release receipt per consumed booking and decrementing &#x60;sold_count&#x60; under the GA row lock (409 &#x60;insufficient_booked_places&#x60; with &#x60;available&#x60;). Buyer purchases are never released here. - &#x60;RELEASE&#x60; with &#x60;holdToken&#x60; (GA hold token): releases that many places held by the token (409 &#x60;insufficient_held_places&#x60;, &#x60;hold_token_conflict&#x60;). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor &#x60;sold_count&#x60; go below zero. Response &#x60;gaAreas: { &lt;areaId&gt;: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }&#x60;.  **&#x60;allowedPreviousStatuses&#x60; / &#x60;rejectedPreviousStatuses&#x60;**: &#x60;free&#x60;, &#x60;booked&#x60;, &#x60;resale&#x60;, &#x60;reservedByToken&#x60;, &#x60;retired&#x60; or a custom status. On violation nothing is written and 409 &#x60;illegal_previous_status&#x60; lists every offending object with its current status. For GA quantities the previous status follows from the operation: &#x60;free&#x60; for book/hold, &#x60;booked&#x60; for a release, &#x60;reservedByToken&#x60; for a release by &#x60;holdToken&#x60;.  **&#x60;holdToken&#x60;**: with status &#x60;booked&#x60;, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 &#x60;hold_token_conflict&#x60;. Remaining seats of the session stay held. With &#x60;RELEASE&#x60; it releases GA places (see above).  **&#x60;ticketType&#x60;** (per object, &#x60;{ objectId, ticketType }&#x60;, status &#x60;booked&#x60; only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **&#x60;keepExtraData&#x60;**: keeps the stored extraData; per-object &#x60;extraData&#x60; sent with it is merged on top (without it, the object&#39;s extraData is replaced by the one sent, or cleared).  **&#x60;ticketBuyerId&#x60;** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId&#x3D;….  **&#x60;channelKeys&#x60;** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 &#x60;channel_forbidden&#x60; otherwise). Without &#x60;channelKeys&#x60;, or with &#x60;ignoreChannels: true&#x60;, channel partitions are ignored (backward-compatible default).  **&#x60;events&#x60;** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with &#x60;results[]&#x60; (&#x60;{ eventId, ok, objects | status, error, message }&#x60;), &#x60;succeeded&#x60; and &#x60;failed&#x60;. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **&#x60;atomic: true&#x60;** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with &#x60;atomic: true&#x60; when everything was applied, otherwise the status of the first failing event and &#x60;results[]&#x60; with &#x60;outcome: failed&#x60; (with &#x60;error&#x60;, &#x60;message&#x60;) or &#x60;rolled_back&#x60; per event — nothing was written. GA administrative holds cannot be atomic (400 &#x60;not_atomic&#x60;).  **&#x60;seasonId&#x60;** (season or partial season id; XOR with &#x60;events&#x60;): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
+    # Resale retains the durable owner and sold status. Optional &#x60;resaleListingId&#x60; groups the objects into one listing (extraData.resaleListingId). Optional &#x60;resalePriceCents&#x60; is stored on extraData and merged into GET /seats on the next cache rebuild. Optional &#x60;listing&#x60; also creates a server-side listing of the objects (type, sellAsWhole, price; see the listings tag): viewers then show and sell it as one listing. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 &#x60;ambiguous_label&#x60;; unknown references return 404 &#x60;objects_not_found&#x60;). General admission areas are addressed by UUID or name **with &#x60;quantity&#x60;** (1–10000): - &#x60;booked&#x60;: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then &#x60;sold_count&#x60; is incremented in the transaction with a &#x60;sold_count + quantity &lt;&#x3D; capacity&#x60; guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - &#x60;reservedByToken&#x60; (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (&#x60;hold: { holdToken, holdUserId, holdExpiresAt }&#x60;), confirmable with POST /ga/confirm (&#x60;holdToken&#x60;, &#x60;userId&#x60; &#x3D; &#x60;holdUserId&#x60;). Optional &#x60;userId&#x60; (customer identity of the hold; one hold per user and area, 409 &#x60;hold_exists&#x60;) and &#x60;holdExpiresInMinutes&#x60; (1–120). 409 &#x60;insufficient_capacity&#x60;. - &#x60;RELEASE&#x60; / &#x60;free&#x60; without &#x60;holdToken&#x60;: releases places of **administrative** bookings (newest receipts first, optionally only those of &#x60;orderId&#x60;), recording a release receipt per consumed booking and decrementing &#x60;sold_count&#x60; under the GA row lock (409 &#x60;insufficient_booked_places&#x60; with &#x60;available&#x60;). Buyer purchases are never released here. - &#x60;RELEASE&#x60; with &#x60;holdToken&#x60; (GA hold token): releases that many places held by the token (409 &#x60;insufficient_held_places&#x60;, &#x60;hold_token_conflict&#x60;). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor &#x60;sold_count&#x60; go below zero. Response &#x60;gaAreas: { &lt;areaId&gt;: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }&#x60;.  **&#x60;allowedPreviousStatuses&#x60; / &#x60;rejectedPreviousStatuses&#x60;**: &#x60;free&#x60;, &#x60;booked&#x60;, &#x60;resale&#x60;, &#x60;reservedByToken&#x60;, &#x60;retired&#x60; or a custom status. On violation nothing is written and 409 &#x60;illegal_previous_status&#x60; lists every offending object with its current status. For GA quantities the previous status follows from the operation: &#x60;free&#x60; for book/hold, &#x60;booked&#x60; for a release, &#x60;reservedByToken&#x60; for a release by &#x60;holdToken&#x60;.  **&#x60;holdToken&#x60;**: with status &#x60;booked&#x60;, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 &#x60;hold_token_conflict&#x60;. Remaining seats of the session stay held. With &#x60;RELEASE&#x60; it releases GA places (see above).  **&#x60;ticketType&#x60;** (per object, &#x60;{ objectId, ticketType }&#x60;, status &#x60;booked&#x60; only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **&#x60;keepExtraData&#x60;**: keeps the stored extraData; per-object &#x60;extraData&#x60; sent with it is merged on top (without it, the object&#39;s extraData is replaced by the one sent, or cleared).  **&#x60;ticketBuyerId&#x60;** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId&#x3D;….  **&#x60;channelKeys&#x60;** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 &#x60;channel_forbidden&#x60; otherwise). Without &#x60;channelKeys&#x60;, or with &#x60;ignoreChannels: true&#x60;, channel partitions are ignored (backward-compatible default).  **&#x60;events&#x60;** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with &#x60;results[]&#x60; (&#x60;{ eventId, ok, objects | status, error, message }&#x60;), &#x60;succeeded&#x60; and &#x60;failed&#x60;. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **&#x60;atomic: true&#x60;** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with &#x60;atomic: true&#x60; when everything was applied, otherwise the status of the first failing event and &#x60;results[]&#x60; with &#x60;outcome: failed&#x60; (with &#x60;error&#x60;, &#x60;message&#x60;) or &#x60;rolled_back&#x60; per event — nothing was written. GA administrative holds cannot be atomic (400 &#x60;not_atomic&#x60;).  **&#x60;seasonId&#x60;** (season or partial season id; XOR with &#x60;events&#x60;): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
     # @param event_id [String] 
     # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
     # @param [Hash] opts the optional parameters

data/lib/seatschart/api/seasons_api.rb

@@ -479,7 +479,7 @@ module SeatsChart
     end
 
     # List partial seasons of a season
-    # Response `{ partialSeasons: [{ id, seasonId, name, eventIds, createdAt }] }`. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Response `{ partialSeasons: [{ id, seasonId, key, name, eventIds, createdAt }] }`. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -489,7 +489,7 @@ module SeatsChart
     end
 
     # List partial seasons of a season
-    # Response `{ partialSeasons: [{ id, seasonId, name, eventIds, createdAt }] }`. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Response `{ partialSeasons: [{ id, seasonId, key, name, eventIds, createdAt }] }`. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -548,7 +548,7 @@ module SeatsChart
     end
 
     # Get one partial season
-    # Response `{ partialSeason: { id, seasonId, name, eventIds, createdAt } }`; 404 when it is not a partial season of this season. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Response `{ partialSeason: { id, seasonId, key, name, eventIds, createdAt } }`; 404 when it is not a partial season of this season. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param partial_season_id [String] 
     # @param [Hash] opts the optional parameters
@@ -559,7 +559,7 @@ module SeatsChart
     end
 
     # Get one partial season
-    # Response &#x60;{ partialSeason: { id, seasonId, name, eventIds, createdAt } }&#x60;; 404 when it is not a partial season of this season. Booking or releasing with &#x60;seasonId&#x60; set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Response &#x60;{ partialSeason: { id, seasonId, key, name, eventIds, createdAt } }&#x60;; 404 when it is not a partial season of this season. Booking or releasing with &#x60;seasonId&#x60; set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param partial_season_id [String] 
     # @param [Hash] opts the optional parameters
@@ -4330,7 +4330,7 @@ module SeatsChart
     end
 
     # Update season
-    # Rename or set sourceEventId (must be a member). Clearing source blocks sync until reset.
+    # Rename, set / rename / clear the partner `key` (409 `season_key_taken`), or set sourceEventId (must be a member). Clearing source blocks sync until reset.
     # @param season_id [String] 
     # @param patch_api_seasons_by_season_id_request [PatchApiSeasonsBySeasonIdRequest] 
     # @param [Hash] opts the optional parameters
@@ -4342,7 +4342,7 @@ module SeatsChart
     end
 
     # Update season
-    # Rename or set sourceEventId (must be a member). Clearing source blocks sync until reset.
+    # Rename, set / rename / clear the partner &#x60;key&#x60; (409 &#x60;season_key_taken&#x60;), or set sourceEventId (must be a member). Clearing source blocks sync until reset.
     # @param season_id [String] 
     # @param patch_api_seasons_by_season_id_request [PatchApiSeasonsBySeasonIdRequest] 
     # @param [Hash] opts the optional parameters
@@ -4525,6 +4525,111 @@ module SeatsChart
       return data, status_code, headers
     end
 
+    # Rename a partial season or set its key
+    # Changes `name` and/or `key` (a key sets or renames it; `null` or `\"\"` clears it; 409 `partial_season_key_taken`). Response `{ partialSeason }`. Partner `key`: unique within the season, 1–100 URL-safe characters, never UUID-shaped; usable in place of the partial season id in every partial season path (`/seasons/{seasonIdOrKey}/partial-seasons/{partialSeasonIdOrKey}`), and as body `seasonId` of booking and status changes when no season and no other partial season of the workspace uses it.
+    # @param season_id [String] 
+    # @param partial_season_id [String] 
+    # @param patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request [PatchApiSeasonsBySeasonIdPartialSeasonsByPartialSeasonIdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [nil]
+    def patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id(season_id, partial_season_id, patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request, opts = {})
+      patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_with_http_info(season_id, partial_season_id, patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request, opts)
+      nil
+    end
+
+    # Rename a partial season or set its key
+    # Changes &#x60;name&#x60; and/or &#x60;key&#x60; (a key sets or renames it; &#x60;null&#x60; or &#x60;\&quot;\&quot;&#x60; clears it; 409 &#x60;partial_season_key_taken&#x60;). Response &#x60;{ partialSeason }&#x60;. Partner &#x60;key&#x60;: unique within the season, 1–100 URL-safe characters, never UUID-shaped; usable in place of the partial season id in every partial season path (&#x60;/seasons/{seasonIdOrKey}/partial-seasons/{partialSeasonIdOrKey}&#x60;), and as body &#x60;seasonId&#x60; of booking and status changes when no season and no other partial season of the workspace uses it.
+    # @param season_id [String] 
+    # @param partial_season_id [String] 
+    # @param patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request [PatchApiSeasonsBySeasonIdPartialSeasonsByPartialSeasonIdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_with_http_info(season_id, partial_season_id, patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id ...'
+      end
+      # verify the required parameter 'season_id' is set
+      if @api_client.config.client_side_validation && season_id.nil?
+        fail ArgumentError, "Missing the required parameter 'season_id' when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id"
+      end
+      if @api_client.config.client_side_validation && season_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "season_id" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && season_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "season_id" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'partial_season_id' is set
+      if @api_client.config.client_side_validation && partial_season_id.nil?
+        fail ArgumentError, "Missing the required parameter 'partial_season_id' when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id"
+      end
+      if @api_client.config.client_side_validation && partial_season_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "partial_season_id" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && partial_season_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "partial_season_id" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request' is set
+      if @api_client.config.client_side_validation && patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request.nil?
+        fail ArgumentError, "Missing the required parameter 'patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request' when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/seasons/{seasonId}/partial-seasons/{partialSeasonId}'.sub('{' + 'seasonId' + '}', CGI.escape(season_id.to_s)).sub('{' + 'partialSeasonId' + '}', CGI.escape(partial_season_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SeasonsApi.patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SeasonsApi#patch_api_seasons_by_season_id_partial_seasons_by_partial_season_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Override the season status of objects in an event (OVERRIDE_SEASON_STATUS)
     # Requires **Idempotency-Key**. The objects of the path event (a non-source season member) stop following the season status. Idempotent per object. Response `{ ok, eventId, seasonId, overridden, added, released, objects? }`.  **No overbooking.** Every object keeps exactly one authority per event (its seat row and Redis key), so an override only changes which (event, object) pairs the season fan-outs touch: season booking (`seasonId` on reserve), season status changes (`seasonId` on change-object-status), season inventory sync and the season booking view skip overridden pairs. Overriding never changes the status: a seat booked for the season stays booked in the event. `release: true` frees the objects in this event only. Unsold objects go through the administrative transition engine (held seats and accepted orders are refused, 409 `inventory_conflict`). Sold objects are refused with 409 `season_booked` (`objects: [{ objectId, label, orderId, seasonTicket }]`) unless `allowBookedRelease: true` is sent explicitly; then only seats of a season (multi-event) order are given back for this event, under the seat row lock: the reservation and the order item of this event are cancelled (`season_status_override`), the seat becomes available and its Redis confirmed marker is cleared; the order stays confirmed for its other events (refunds are up to you). The event's own sales are never released here (409 `event_sale`: cancel the order). Nothing changes on any refusal. The season source event cannot override (409 `season_source_event`); events outside a season get 409 `not_season_member`.
     # @param event_id [String] 
@@ -5240,7 +5345,7 @@ module SeatsChart
     end
 
     # Create a partial season
-    # Every event must already be a member of the parent season (400 `not_season_member` lists the others). Max 100 partial seasons per season. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Every event must already be a member of the parent season (400 `not_season_member` lists the others). Max 100 partial seasons per season. 409 `partial_season_key_taken`. Partner `key`: unique within the season, 1–100 URL-safe characters, never UUID-shaped; usable in place of the partial season id in every partial season path (`/seasons/{seasonIdOrKey}/partial-seasons/{partialSeasonIdOrKey}`), and as body `seasonId` of booking and status changes when no season and no other partial season of the workspace uses it. Booking or releasing with `seasonId` set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param post_api_seasons_by_season_id_partial_seasons_request [PostApiSeasonsBySeasonIdPartialSeasonsRequest] 
     # @param [Hash] opts the optional parameters
@@ -5252,7 +5357,7 @@ module SeatsChart
     end
 
     # Create a partial season
-    # Every event must already be a member of the parent season (400 &#x60;not_season_member&#x60; lists the others). Max 100 partial seasons per season. Booking or releasing with &#x60;seasonId&#x60; set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
+    # Every event must already be a member of the parent season (400 &#x60;not_season_member&#x60; lists the others). Max 100 partial seasons per season. 409 &#x60;partial_season_key_taken&#x60;. Partner &#x60;key&#x60;: unique within the season, 1–100 URL-safe characters, never UUID-shaped; usable in place of the partial season id in every partial season path (&#x60;/seasons/{seasonIdOrKey}/partial-seasons/{partialSeasonIdOrKey}&#x60;), and as body &#x60;seasonId&#x60; of booking and status changes when no season and no other partial season of the workspace uses it. Booking or releasing with &#x60;seasonId&#x60; set to a partial season id on POST /api/events/:eventId/actions/change-object-status fans out to the partial season members only, atomically, exactly like a full season.
     # @param season_id [String] 
     # @param post_api_seasons_by_season_id_partial_seasons_request [PostApiSeasonsBySeasonIdPartialSeasonsRequest] 
     # @param [Hash] opts the optional parameters

data/lib/seatschart/api/seats_api.rb

@@ -699,33 +699,27 @@ module SeatsChart
 
     # Accept a durable confirmation intent before asynchronous seat materialization
     # Server-to-server only (`x-api-key`). **Pricing source** (workspace integration mode or event sales rules): `partner` events confirm the declared `seatTicketTypes` and `seatPrices` (or `paidAmountCents`) without a quote; `synced_catalog` events validate them against the pushed price table (409 `price_mismatch`, `price_table_missing`, `ticket_type_required`); `seatschart_catalog` events require a durable catalog quote created before external payment. Final ticket types are re-checked against the event quotas and buyer limit (409 `quota_exceeded`, `buyer_limit_exceeded`, `lot_sold_out`). Configure event currency before quoting. The organizer's booking limits are re-checked (defence in depth; holds enforce them atomically): 409 `booking_limit_exceeded` (`limit`, `requested`), except for holds placed before the current limits were published. After verifying payment with your provider, send quoteId, externalPaymentId, paidAmountCents, paidCurrency and the **`holdToken`** capability returned via `POST /api/seats/reserve`. These payment fields are the authenticated partner's attestation, not gateway verification by SeatsChart. Retries of already accepted legacy decisions remain supported without a quote. Consumer JWTs are rejected — confirmation must not run from the browser. Validates Redis holds, then commits the order and requested items in PostgreSQL before 202. Stream delivery is a best-effort trigger; pending SQL items are reconciled by the worker. Provide externalOrderId for stable partner identity. Legacy callers use a durable tenant-scoped Idempotency-Key identity. Season/group holds require scope=hold and the full source seatIds set; all frozen destinations form one atomic order. GET /api/orders/:orderId reports the atomic cart outcome. HTTP keys are durably bound to the authenticated credential and request; changed payload returns 409. Optional `ticketBuyerId` (opaque partner buyer id) is stored on the order, its reservations and object statuses; when omitted it is inherited from the hold token. Quote failures return 409 with `error: quote_required` (no quoteId) or `error: quote_mismatch` (quote or payment attestation does not match).
-    # @param x_api_key [String] Partner B2B API key (required for payment commit).
     # @param idempotency_key [String] Required key (max 255 chars after trim); durable fallback identity when externalOrderId is omitted.
     # @param post_api_seats_confirm_request [PostApiSeatsConfirmRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_tenant_id Ignored for bootstrap env keys (bound to DEFAULT_TENANT_ID). Dashboard `sk_live_…` keys are tenant-scoped by hash.
     # @return [nil]
-    def post_api_seats_confirm(x_api_key, idempotency_key, post_api_seats_confirm_request, opts = {})
-      post_api_seats_confirm_with_http_info(x_api_key, idempotency_key, post_api_seats_confirm_request, opts)
+    def post_api_seats_confirm(idempotency_key, post_api_seats_confirm_request, opts = {})
+      post_api_seats_confirm_with_http_info(idempotency_key, post_api_seats_confirm_request, opts)
       nil
     end
 
     # Accept a durable confirmation intent before asynchronous seat materialization
     # Server-to-server only (`x-api-key`). **Pricing source** (workspace integration mode or event sales rules): `partner` events confirm the declared `seatTicketTypes` and `seatPrices` (or `paidAmountCents`) without a quote; `synced_catalog` events validate them against the pushed price table (409 `price_mismatch`, `price_table_missing`, `ticket_type_required`); `seatschart_catalog` events require a durable catalog quote created before external payment. Final ticket types are re-checked against the event quotas and buyer limit (409 `quota_exceeded`, `buyer_limit_exceeded`, `lot_sold_out`). Configure event currency before quoting. The organizer's booking limits are re-checked (defence in depth; holds enforce them atomically): 409 `booking_limit_exceeded` (`limit`, `requested`), except for holds placed before the current limits were published. After verifying payment with your provider, send quoteId, externalPaymentId, paidAmountCents, paidCurrency and the **`holdToken`** capability returned via `POST /api/seats/reserve`. These payment fields are the authenticated partner's attestation, not gateway verification by SeatsChart. Retries of already accepted legacy decisions remain supported without a quote. Consumer JWTs are rejected — confirmation must not run from the browser. Validates Redis holds, then commits the order and requested items in PostgreSQL before 202. Stream delivery is a best-effort trigger; pending SQL items are reconciled by the worker. Provide externalOrderId for stable partner identity. Legacy callers use a durable tenant-scoped Idempotency-Key identity. Season/group holds require scope=hold and the full source seatIds set; all frozen destinations form one atomic order. GET /api/orders/:orderId reports the atomic cart outcome. HTTP keys are durably bound to the authenticated credential and request; changed payload returns 409. Optional `ticketBuyerId` (opaque partner buyer id) is stored on the order, its reservations and object statuses; when omitted it is inherited from the hold token. Quote failures return 409 with `error: quote_required` (no quoteId) or `error: quote_mismatch` (quote or payment attestation does not match).
-    # @param x_api_key [String] Partner B2B API key (required for payment commit).
     # @param idempotency_key [String] Required key (max 255 chars after trim); durable fallback identity when externalOrderId is omitted.
     # @param post_api_seats_confirm_request [PostApiSeatsConfirmRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_tenant_id Ignored for bootstrap env keys (bound to DEFAULT_TENANT_ID). Dashboard `sk_live_…` keys are tenant-scoped by hash.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def post_api_seats_confirm_with_http_info(x_api_key, idempotency_key, post_api_seats_confirm_request, opts = {})
+    def post_api_seats_confirm_with_http_info(idempotency_key, post_api_seats_confirm_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: SeatsApi.post_api_seats_confirm ...'
       end
-      # verify the required parameter 'x_api_key' is set
-      if @api_client.config.client_side_validation && x_api_key.nil?
-        fail ArgumentError, "Missing the required parameter 'x_api_key' when calling SeatsApi.post_api_seats_confirm"
-      end
       # verify the required parameter 'idempotency_key' is set
       if @api_client.config.client_side_validation && idempotency_key.nil?
         fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling SeatsApi.post_api_seats_confirm"
@@ -749,7 +743,6 @@ module SeatsChart
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
-      header_params[:'x-api-key'] = x_api_key
       header_params[:'Idempotency-Key'] = idempotency_key
       header_params[:'x-tenant-id'] = opts[:'x_tenant_id'] if !opts[:'x_tenant_id'].nil?
 
@@ -941,8 +934,6 @@ module SeatsChart
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim); 24h cache replay in Redis per tenant + route.
     # @param post_api_seats_release_request [PostApiSeatsReleaseRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_api_key Partner B2B API key (alternative to Bearer).
-    # @option opts [String] :authorization Bearer + HS256 JWT for B2C clients.
     # @option opts [String] :x_tenant_id Tenant id for partner integrations.
     # @return [nil]
     def post_api_seats_release(idempotency_key, post_api_seats_release_request, opts = {})
@@ -955,8 +946,6 @@ module SeatsChart
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim); 24h cache replay in Redis per tenant + route.
     # @param post_api_seats_release_request [PostApiSeatsReleaseRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_api_key Partner B2B API key (alternative to Bearer).
-    # @option opts [String] :authorization Bearer + HS256 JWT for B2C clients.
     # @option opts [String] :x_tenant_id Tenant id for partner integrations.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def post_api_seats_release_with_http_info(idempotency_key, post_api_seats_release_request, opts = {})
@@ -985,8 +974,6 @@ module SeatsChart
           header_params['Content-Type'] = content_type
       end
       header_params[:'Idempotency-Key'] = idempotency_key
-      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
-      header_params[:'Authorization'] = opts[:'authorization'] if !opts[:'authorization'].nil?
       header_params[:'x-tenant-id'] = opts[:'x_tenant_id'] if !opts[:'x_tenant_id'].nil?
 
       # form parameters
@@ -1023,8 +1010,6 @@ module SeatsChart
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim; UUID v4 recommended). 24h idempotent cache replay in Redis per tenant.
     # @param post_api_seats_reserve_request [PostApiSeatsReserveRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_api_key Partner B2B API key (alternative to Bearer).
-    # @option opts [String] :authorization Bearer + HS256 JWT for B2C clients.
     # @option opts [String] :x_tenant_id Tenant id for partner integrations.
     # @return [nil]
     def post_api_seats_reserve(idempotency_key, post_api_seats_reserve_request, opts = {})
@@ -1037,8 +1022,6 @@ module SeatsChart
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim; UUID v4 recommended). 24h idempotent cache replay in Redis per tenant.
     # @param post_api_seats_reserve_request [PostApiSeatsReserveRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_api_key Partner B2B API key (alternative to Bearer).
-    # @option opts [String] :authorization Bearer + HS256 JWT for B2C clients.
     # @option opts [String] :x_tenant_id Tenant id for partner integrations.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def post_api_seats_reserve_with_http_info(idempotency_key, post_api_seats_reserve_request, opts = {})
@@ -1067,8 +1050,6 @@ module SeatsChart
           header_params['Content-Type'] = content_type
       end
       header_params[:'Idempotency-Key'] = idempotency_key
-      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
-      header_params[:'Authorization'] = opts[:'authorization'] if !opts[:'authorization'].nil?
       header_params[:'x-tenant-id'] = opts[:'x_tenant_id'] if !opts[:'x_tenant_id'].nil?
 
       # form parameters

data/lib/seatschart/api/usage_api.rb

@@ -19,8 +19,8 @@ module SeatsChart
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Request monitoring per rate-limit lane
-    # Peak requests per minute and 429 counts per lane for the last 10 minutes, hour, 24 hours or 7 days. The **sales lane** carries the buyer path (seat map reads, manifest/geometry/state, the live stream, holds, renewals, best-available, releases, quotes, confirmations); the **api lane** carries everything else (reports, events, charts, workspaces, webhooks, keys), so reporting bursts never starve sales. Counters are written by the rate limiter in its existing Redis call (no extra round trip); minute data is kept 25 hours, hourly peaks 8 days. 10m/1h: one bucket per minute; 24h: 15-minute buckets (peak minute); 7d: hourly buckets. Dashboard session (any role) or an API key with the `reports` scope.
+    # Request monitoring per rate-limit lane, with in-flight (concurrent) requests
+    # Peak requests per minute and 429 counts per lane for the last 10 minutes, hour, 24 hours or 7 days. The **sales lane** carries the buyer path (seat map reads, manifest/geometry/state, the live stream, holds, renewals, best-available, releases, quotes, confirmations); the **api lane** carries everything else (reports, events, charts, workspaces, webhooks, keys), so reporting bursts never starve sales. Counters are written by the rate limiter in its existing Redis call (no extra round trip); minute data is kept 25 hours, hourly peaks 8 days. 10m/1h: one bucket per minute; 24h: 15-minute buckets (peak minute); 7d: hourly buckets. `concurrency` reports requests in flight now and the highest number of concurrent requests in the last hour and day, for the workspace and per API key (live SSE streams are connections and are not counted). Each API instance counts in memory and stores a new per-minute peak in the same limiter call, so with several instances the peaks are summed (an upper bound) and `current` is the instance that answered. Dashboard session (any role) or an API key with the `reports` scope.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :range Time range (default `1h`).
     # @return [GetApiMonitoringRequests200Response]
@@ -29,8 +29,8 @@ module SeatsChart
       data
     end
 
-    # Request monitoring per rate-limit lane
-    # Peak requests per minute and 429 counts per lane for the last 10 minutes, hour, 24 hours or 7 days. The **sales lane** carries the buyer path (seat map reads, manifest/geometry/state, the live stream, holds, renewals, best-available, releases, quotes, confirmations); the **api lane** carries everything else (reports, events, charts, workspaces, webhooks, keys), so reporting bursts never starve sales. Counters are written by the rate limiter in its existing Redis call (no extra round trip); minute data is kept 25 hours, hourly peaks 8 days. 10m/1h: one bucket per minute; 24h: 15-minute buckets (peak minute); 7d: hourly buckets. Dashboard session (any role) or an API key with the `reports` scope.
+    # Request monitoring per rate-limit lane, with in-flight (concurrent) requests
+    # Peak requests per minute and 429 counts per lane for the last 10 minutes, hour, 24 hours or 7 days. The **sales lane** carries the buyer path (seat map reads, manifest/geometry/state, the live stream, holds, renewals, best-available, releases, quotes, confirmations); the **api lane** carries everything else (reports, events, charts, workspaces, webhooks, keys), so reporting bursts never starve sales. Counters are written by the rate limiter in its existing Redis call (no extra round trip); minute data is kept 25 hours, hourly peaks 8 days. 10m/1h: one bucket per minute; 24h: 15-minute buckets (peak minute); 7d: hourly buckets. `concurrency` reports requests in flight now and the highest number of concurrent requests in the last hour and day, for the workspace and per API key (live SSE streams are connections and are not counted). Each API instance counts in memory and stores a new per-minute peak in the same limiter call, so with several instances the peaks are summed (an upper bound) and `current` is the instance that answered. Dashboard session (any role) or an API key with the `reports` scope.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :range Time range (default `1h`).
     # @return [Array<(GetApiMonitoringRequests200Response, Integer, Hash)>] GetApiMonitoringRequests200Response data, response status code and response headers

data/lib/seatschart/api/webhooks_api.rb

@@ -332,7 +332,7 @@ module SeatsChart
     end
 
     # List subscribable webhook event types
-    # Event types an endpoint can subscribe to through `eventTypes`. `webhook.test` is sent only by `POST /api/webhooks/{id}/test` and cannot be subscribed to.
+    # Event types an endpoint can subscribe to through `eventTypes`. `webhook.test` is sent only by `POST /api/webhooks/{id}/test` and cannot be subscribed to. `aliases`: seats.io-named aliases (`{ type, aliasOf }`), opt-in per endpoint: the aliased event is delivered again under the alias name to endpoints that list it explicitly (same payload, `type` = alias); `[\"*\"]` does not include aliases.
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def get_api_webhooks_event_types(opts = {})
@@ -341,7 +341,7 @@ module SeatsChart
     end
 
     # List subscribable webhook event types
-    # Event types an endpoint can subscribe to through `eventTypes`. `webhook.test` is sent only by `POST /api/webhooks/{id}/test` and cannot be subscribed to.
+    # Event types an endpoint can subscribe to through `eventTypes`. `webhook.test` is sent only by `POST /api/webhooks/{id}/test` and cannot be subscribed to. `aliases`: seats.io-named aliases (`{ type, aliasOf }`), opt-in per endpoint: the aliased event is delivered again under the alias name to endpoints that list it explicitly (same payload, `type` = alias); `[\"*\"]` does not include aliases.
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def get_api_webhooks_event_types_with_http_info(opts = {})

data/lib/seatschart/api/workspace_api.rb

@@ -269,7 +269,7 @@ module SeatsChart
     end
 
     # Get workspace settings (effective value and source)
-    # Effective value of every workspace setting, the default it inherits and whether it is overridden. Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
+    # Effective value of every workspace setting, the default it inherits and whether it is overridden. Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`); `newEventsNotForSale` (default off) — new events start with every seat and GA area not for sale (seats.io workspace for-sale mode; an explicit `forSaleConfig` at creation wins, season members still follow the season source). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
     # @param [Hash] opts the optional parameters
     # @return [GetApiWorkspaceSettings200Response]
     def get_api_workspace_settings(opts = {})
@@ -278,7 +278,7 @@ module SeatsChart
     end
 
     # Get workspace settings (effective value and source)
-    # Effective value of every workspace setting, the default it inherits and whether it is overridden. Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
+    # Effective value of every workspace setting, the default it inherits and whether it is overridden. Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`); `newEventsNotForSale` (default off) — new events start with every seat and GA area not for sale (seats.io workspace for-sale mode; an explicit `forSaleConfig` at creation wins, season members still follow the season source). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetApiWorkspaceSettings200Response, Integer, Hash)>] GetApiWorkspaceSettings200Response data, response status code and response headers
     def get_api_workspace_settings_with_http_info(opts = {})
@@ -683,7 +683,7 @@ module SeatsChart
     end
 
     # Override workspace settings or return them to the default
-    # Workspace admins only (dashboard session). A value overrides the default for this workspace; `null` returns the setting to the default; omitted settings are unchanged. Takes effect immediately on this API instance and within 5 seconds on the others (read from the tenant config cache; no per-request query). Every change is audited (`workspace.settings.update`). Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
+    # Workspace admins only (dashboard session). A value overrides the default for this workspace; `null` returns the setting to the default; omitted settings are unchanged. Takes effect immediately on this API instance and within 5 seconds on the others (read from the tenant config cache; no per-request query). Every change is audited (`workspace.settings.update`). Settings: `holdPeriodMinutes` (1–120; default `SEAT_HOLD_TTL_SEC`, 10 min) — TTL of new and renewed seat/GA holds; `maxSeatsPerHoldToken` (1–64; default 64) — seats one hold token may hold across appends; `ticketBuyerValidation` (default off) — buyer tokens are minted only for a registered ticket buyer id (`POST /ticket-buyers`) and bind it, buyer holds must carry it; `gaPlacesToChannels` (default on) — inventory channels may receive GA place quotas (`areaPlaces`); `newEventsNotForSale` (default off) — new events start with every seat and GA area not for sale (seats.io workspace for-sale mode; an explicit `forSaleConfig` at creation wins, season members still follow the season source). Each setting either uses the platform default or is overridden for this workspace; `sources` says which.
     # @param patch_api_workspace_settings_request [PatchApiWorkspaceSettingsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
@@ -694,7 +694,7 @@ module SeatsChart
     end
 
     # Override workspace settings or return them to the default
-    # Workspace admins only (dashboard session). A value overrides the default for this workspace; &#x60;null&#x60; returns the setting to the default; omitted settings are unchanged. Takes effect immediately on this API instance and within 5 seconds on the others (read from the tenant config cache; no per-request query). Every change is audited (&#x60;workspace.settings.update&#x60;). Settings: &#x60;holdPeriodMinutes&#x60; (1–120; default &#x60;SEAT_HOLD_TTL_SEC&#x60;, 10 min) — TTL of new and renewed seat/GA holds; &#x60;maxSeatsPerHoldToken&#x60; (1–64; default 64) — seats one hold token may hold across appends; &#x60;ticketBuyerValidation&#x60; (default off) — buyer tokens are minted only for a registered ticket buyer id (&#x60;POST /ticket-buyers&#x60;) and bind it, buyer holds must carry it; &#x60;gaPlacesToChannels&#x60; (default on) — inventory channels may receive GA place quotas (&#x60;areaPlaces&#x60;). Each setting either uses the platform default or is overridden for this workspace; &#x60;sources&#x60; says which.
+    # Workspace admins only (dashboard session). A value overrides the default for this workspace; &#x60;null&#x60; returns the setting to the default; omitted settings are unchanged. Takes effect immediately on this API instance and within 5 seconds on the others (read from the tenant config cache; no per-request query). Every change is audited (&#x60;workspace.settings.update&#x60;). Settings: &#x60;holdPeriodMinutes&#x60; (1–120; default &#x60;SEAT_HOLD_TTL_SEC&#x60;, 10 min) — TTL of new and renewed seat/GA holds; &#x60;maxSeatsPerHoldToken&#x60; (1–64; default 64) — seats one hold token may hold across appends; &#x60;ticketBuyerValidation&#x60; (default off) — buyer tokens are minted only for a registered ticket buyer id (&#x60;POST /ticket-buyers&#x60;) and bind it, buyer holds must carry it; &#x60;gaPlacesToChannels&#x60; (default on) — inventory channels may receive GA place quotas (&#x60;areaPlaces&#x60;); &#x60;newEventsNotForSale&#x60; (default off) — new events start with every seat and GA area not for sale (seats.io workspace for-sale mode; an explicit &#x60;forSaleConfig&#x60; at creation wins, season members still follow the season source). Each setting either uses the platform default or is overridden for this workspace; &#x60;sources&#x60; says which.
     # @param patch_api_workspace_settings_request [PatchApiWorkspaceSettingsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.