seatschart 0.1.0

data/lib/seatschart/api/object_status_api.rb

@@ -0,0 +1,805 @@
+=begin
+#SeatsChart API
+
+#Seat inventory and locking API for B2B2C integrations. Authenticate using `x-api-key` (partners) or `Authorization: Bearer` with an HS256 JWT.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+require 'cgi'
+
+module SeatsChart
+  class ObjectStatusApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List object status overlays for an event
+    # Ops overlay (custom / resale / extraData). Distinct from Redis holds. See docs/SEATSIO_PARITY.md.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_events_by_event_id_object_statuses(event_id, opts = {})
+      get_api_events_by_event_id_object_statuses_with_http_info(event_id, opts)
+      nil
+    end
+
+    # List object status overlays for an event
+    # Ops overlay (custom / resale / extraData). Distinct from Redis holds. See docs/SEATSIO_PARITY.md.
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_events_by_event_id_object_statuses_with_http_info(event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.get_api_events_by_event_id_object_statuses ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.get_api_events_by_event_id_object_statuses"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.get_api_events_by_event_id_object_statuses, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.get_api_events_by_event_id_object_statuses, the character length must be great than or equal to 36.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/object-statuses'.sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.get_api_events_by_event_id_object_statuses",
+        :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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#get_api_events_by_event_id_object_statuses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Atomically change object statuses across events (all-or-nothing batch)
+    # Applies several status changes — different events, statuses, hold tokens and orders — **all-or-nothing in one SQL transaction**. Either every change is applied or none is; there is never a partial result to reconcile.  **Body**: `statusChanges[]` (1–100; at most 512 objects overall), each with exactly one of `eventId` / `eventKey`, `objects` (seat UUID or label; GA area id or name with `quantity`; optional per-object `ticketType` for bookings), `status` (or `type: RELEASE`) and the same optional fields as POST /events/{eventId}/actions/change-object-status: `orderId`, `holdToken` (book seats held by a buyer hold token), `keepExtraData`, `resalePriceCents`, `resaleListingId`, `allowedPreviousStatuses` / `rejectedPreviousStatuses`, `channelKeys` / `ignoreChannels`, `ticketBuyerId`. One **Idempotency-Key** covers the whole batch: a replay returns the stored response, a retry after a crash reuses the same booking orders.  **Consistency**: row locks are taken in a deterministic order — booking orders by id, then every seat of every change by (eventId, seatId), then GA areas by (eventId, areaId) — so concurrent batches on overlapping seats serialize instead of deadlocking (a database-detected deadlock is retried transparently). Buyer holds are honoured exactly as for a single-event change: a seat held by a buyer (Redis hold lock, read under the seat row lock) is never booked unless its `holdToken` is supplied, hold sessions are frozen before the transaction, and GA places are first reserved in the same structure buyers hold from, so capacity can never be exceeded.  **Not atomic, refused with 400 `not_atomic`**: administrative GA holds (`reservedByToken`) and GA releases by hold token (they live in Redis only). An object or hold token may appear in only one change (400 `duplicate_object` / `duplicate_hold_token`).  **Responses**: 200 `{ results: [{ index, eventId, outcome: \"applied\", objects, gaAreas }] }` in request order. On any failure nothing is written and the status is that of the first failing change (400, 404, 409), with `{ error, message, failed, results: [{ index, eventId, outcome: \"failed\" | \"rolled_back\", status?, error?, message?, objects?, labels? }] }` — every invalid change is reported at once when the request itself is invalid; a conflict found under the row locks reports the change that hit it.
+    # @param post_api_events_actions_change_object_status_request [PostApiEventsActionsChangeObjectStatusRequest] 
+    # @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 post_api_events_actions_change_object_status(post_api_events_actions_change_object_status_request, opts = {})
+      post_api_events_actions_change_object_status_with_http_info(post_api_events_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Atomically change object statuses across events (all-or-nothing batch)
+    # Applies several status changes — different events, statuses, hold tokens and orders — **all-or-nothing in one SQL transaction**. Either every change is applied or none is; there is never a partial result to reconcile.  **Body**: &#x60;statusChanges[]&#x60; (1–100; at most 512 objects overall), each with exactly one of &#x60;eventId&#x60; / &#x60;eventKey&#x60;, &#x60;objects&#x60; (seat UUID or label; GA area id or name with &#x60;quantity&#x60;; optional per-object &#x60;ticketType&#x60; for bookings), &#x60;status&#x60; (or &#x60;type: RELEASE&#x60;) and the same optional fields as POST /events/{eventId}/actions/change-object-status: &#x60;orderId&#x60;, &#x60;holdToken&#x60; (book seats held by a buyer hold token), &#x60;keepExtraData&#x60;, &#x60;resalePriceCents&#x60;, &#x60;resaleListingId&#x60;, &#x60;allowedPreviousStatuses&#x60; / &#x60;rejectedPreviousStatuses&#x60;, &#x60;channelKeys&#x60; / &#x60;ignoreChannels&#x60;, &#x60;ticketBuyerId&#x60;. One **Idempotency-Key** covers the whole batch: a replay returns the stored response, a retry after a crash reuses the same booking orders.  **Consistency**: row locks are taken in a deterministic order — booking orders by id, then every seat of every change by (eventId, seatId), then GA areas by (eventId, areaId) — so concurrent batches on overlapping seats serialize instead of deadlocking (a database-detected deadlock is retried transparently). Buyer holds are honoured exactly as for a single-event change: a seat held by a buyer (Redis hold lock, read under the seat row lock) is never booked unless its &#x60;holdToken&#x60; is supplied, hold sessions are frozen before the transaction, and GA places are first reserved in the same structure buyers hold from, so capacity can never be exceeded.  **Not atomic, refused with 400 &#x60;not_atomic&#x60;**: administrative GA holds (&#x60;reservedByToken&#x60;) and GA releases by hold token (they live in Redis only). An object or hold token may appear in only one change (400 &#x60;duplicate_object&#x60; / &#x60;duplicate_hold_token&#x60;).  **Responses**: 200 &#x60;{ results: [{ index, eventId, outcome: \&quot;applied\&quot;, objects, gaAreas }] }&#x60; in request order. On any failure nothing is written and the status is that of the first failing change (400, 404, 409), with &#x60;{ error, message, failed, results: [{ index, eventId, outcome: \&quot;failed\&quot; | \&quot;rolled_back\&quot;, status?, error?, message?, objects?, labels? }] }&#x60; — every invalid change is reported at once when the request itself is invalid; a conflict found under the row locks reports the change that hit it.
+    # @param post_api_events_actions_change_object_status_request [PostApiEventsActionsChangeObjectStatusRequest] 
+    # @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 post_api_events_actions_change_object_status_with_http_info(post_api_events_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_actions_change_object_status ...'
+      end
+      # verify the required parameter 'post_api_events_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_actions_change_object_status"
+      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 ObjectStatusApi.post_api_events_actions_change_object_status, 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 ObjectStatusApi.post_api_events_actions_change_object_status, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/actions/change-object-status'
+
+      # 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(post_api_events_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_actions_change_object_status",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_actions_change_object_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a durable administrative booking on unheld inventory (or on a hold token)
+    # 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
+    # @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 post_api_events_by_event_id_actions_book(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_book_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Create a durable administrative booking on unheld inventory (or on a hold token)
+    # 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
+    # @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 post_api_events_by_event_id_actions_book_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_book ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_book"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_book, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_book, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_book"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_book, 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 ObjectStatusApi.post_api_events_by_event_id_actions_book, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/book'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_book",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_book\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Change object status (booked / free / resale / retired / custom)
+    # `type: RELEASE` frees objects; otherwise `status` is required. Optional `resalePriceCents` is stored on extraData. 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
+    # @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 post_api_events_by_event_id_actions_change_object_status(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_change_object_status_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Change object status (booked / free / resale / retired / custom)
+    # &#x60;type: RELEASE&#x60; frees objects; otherwise &#x60;status&#x60; is required. Optional &#x60;resalePriceCents&#x60; is stored on extraData. 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
+    # @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 post_api_events_by_event_id_actions_change_object_status_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status, 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 ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/change-object-status'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_change_object_status",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_change_object_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Hold general admission places administratively (issues a GA hold token)
+    # Shortcut for `status: \"reservedByToken\"`; only GA quantities are accepted. 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
+    # @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 post_api_events_by_event_id_actions_hold(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_hold_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Hold general admission places administratively (issues a GA hold token)
+    # Shortcut for &#x60;status: \&quot;reservedByToken\&quot;&#x60;; only GA quantities are accepted. 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
+    # @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 post_api_events_by_event_id_actions_hold_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_hold ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_hold"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_hold, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_hold, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_hold"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_hold, 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 ObjectStatusApi.post_api_events_by_event_id_actions_hold, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/hold'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_hold",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_hold\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    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.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
+    # @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 post_api_events_by_event_id_actions_put_up_for_resale(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_put_up_for_resale_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    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.
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
+    # @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 post_api_events_by_event_id_actions_put_up_for_resale_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale, 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 ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/put-up-for-resale'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_put_up_for_resale",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_put_up_for_resale\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Release unsold objects; sales require explicit order cancellation
+    # 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
+    # @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 post_api_events_by_event_id_actions_release(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_release_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Release unsold objects; sales require explicit order cancellation
+    # 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
+    # @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 post_api_events_by_event_id_actions_release_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_release ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_release"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_release, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_release, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_release"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_release, 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 ObjectStatusApi.post_api_events_by_event_id_actions_release, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/release'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_release",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_release\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retire objects (not for sale, history kept)
+    # 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
+    # @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 post_api_events_by_event_id_actions_retire(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      post_api_events_by_event_id_actions_retire_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts)
+      nil
+    end
+
+    # Retire objects (not for sale, history kept)
+    # 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
+    # @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 post_api_events_by_event_id_actions_retire_with_http_info(event_id, post_api_events_by_event_id_actions_change_object_status_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_retire ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_retire"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_retire, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_retire, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_change_object_status_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_change_object_status_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_retire"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_retire, 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 ObjectStatusApi.post_api_events_by_event_id_actions_retire, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/retire'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_change_object_status_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_retire",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_retire\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update extraData of objects without changing their status
+    # Sets (default) or merges (`merge: true`) `extraData` on up to 64 seats addressed by UUID or label; `extraData: null` clears it. Status, ownership, holds and for-sale flags are never touched. Runs under the same seat row locks as status changes, so it cannot interleave with a concurrent transition. Max 16 KiB of JSON per object. Requires **Idempotency-Key** (replays return the stored response). Every update is written to the audit log (`object.extra_data.update`).
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_update_extra_data_request [PostApiEventsByEventIdActionsUpdateExtraDataRequest] 
+    # @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 post_api_events_by_event_id_actions_update_extra_data(event_id, post_api_events_by_event_id_actions_update_extra_data_request, opts = {})
+      post_api_events_by_event_id_actions_update_extra_data_with_http_info(event_id, post_api_events_by_event_id_actions_update_extra_data_request, opts)
+      nil
+    end
+
+    # Update extraData of objects without changing their status
+    # Sets (default) or merges (&#x60;merge: true&#x60;) &#x60;extraData&#x60; on up to 64 seats addressed by UUID or label; &#x60;extraData: null&#x60; clears it. Status, ownership, holds and for-sale flags are never touched. Runs under the same seat row locks as status changes, so it cannot interleave with a concurrent transition. Max 16 KiB of JSON per object. Requires **Idempotency-Key** (replays return the stored response). Every update is written to the audit log (&#x60;object.extra_data.update&#x60;).
+    # @param event_id [String] 
+    # @param post_api_events_by_event_id_actions_update_extra_data_request [PostApiEventsByEventIdActionsUpdateExtraDataRequest] 
+    # @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 post_api_events_by_event_id_actions_update_extra_data_with_http_info(event_id, post_api_events_by_event_id_actions_update_extra_data_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data ...'
+      end
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data"
+      end
+      if @api_client.config.client_side_validation && event_id.to_s.length > 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data, the character length must be smaller than or equal to 36.'
+      end
+
+      if @api_client.config.client_side_validation && event_id.to_s.length < 36
+        fail ArgumentError, 'invalid value for "event_id" when calling ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data, the character length must be great than or equal to 36.'
+      end
+
+      # verify the required parameter 'post_api_events_by_event_id_actions_update_extra_data_request' is set
+      if @api_client.config.client_side_validation && post_api_events_by_event_id_actions_update_extra_data_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_events_by_event_id_actions_update_extra_data_request' when calling ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data"
+      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 ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data, 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 ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/events/{eventId}/actions/update-extra-data'.sub('{' + 'eventId' + '}', CGI.escape(event_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(post_api_events_by_event_id_actions_update_extra_data_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ObjectStatusApi.post_api_events_by_event_id_actions_update_extra_data",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ObjectStatusApi#post_api_events_by_event_id_actions_update_extra_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end