seatschart 0.4.0 → 0.5.0

data/lib/seatschart/api/seats_api.rb

@@ -374,7 +374,7 @@ module SeatsChart
     end
 
     # Hold GA area capacity (Redis)
-    # Places a temporary hold on unnumbered GA capacity. **Idempotency-Key** is required; repeats within ~24h return the cached hold response. Optional `ticketBuyerId` is stored on the GA hold token and inherited by `POST /ga/confirm`. The organizer's booking limits cap `quantity` (designer *Max GA tickets per order*, else *Max seats per order*; strictest with the sales-channel default): 409 `booking_limit_exceeded` (`limit`, `current`, `requested`, `kind: \"ga\"`). GA tables sold as a whole (`shape.bookAs: \"whole\"`) take every place in one hold: any other `quantity` answers 409 `ga_table_whole` (`capacity`, `requested`). Areas sold as a whole (`areaType` `fixedOccupancy` / `variableOccupancy`) are held for one buyer in one piece: `quantity` is the number of people (fixed: exactly the capacity; variable: `minOccupancy`..capacity), every place of the area is held atomically and a second buyer can never hold part of it. Any other quantity answers 400 `ga_area_whole` (`areaType`, `capacity`, `minOccupancy`, `maxOccupancy`, `requested`); an area already held, sold or partly withheld answers 409 `conflict`. A whole area counts as one object against the booking limits (its capacity, at most 50, caps it); its people count against quotas, lots and per-buyer limits. The response adds `places`, `people` and `areaType`.
+    # Places a temporary hold on unnumbered GA capacity. **Idempotency-Key** is required; repeats within ~24h return the cached hold response. Optional `ticketBuyerId` is stored on the GA hold token and inherited by `POST /ga/confirm`. The organizer's booking limits cap `quantity` (designer *Max GA tickets per order*, else *Max seats per order*; strictest with the sales-channel default): 409 `booking_limit_exceeded` (`limit`, `current`, `requested`, `kind: \"ga\"`). **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. GA tables sold as a whole (`shape.bookAs: \"whole\"`) take every place in one hold: any other `quantity` answers 409 `ga_table_whole` (`capacity`, `requested`). Areas sold as a whole (`areaType` `fixedOccupancy` / `variableOccupancy`) are held for one buyer in one piece: `quantity` is the number of people (fixed: exactly the capacity; variable: `minOccupancy`..capacity), every place of the area is held atomically and a second buyer can never hold part of it. Any other quantity answers 400 `ga_area_whole` (`areaType`, `capacity`, `minOccupancy`, `maxOccupancy`, `requested`); an area already held, sold or partly withheld answers 409 `conflict`. A whole area counts as one object against the booking limits (its capacity, at most 50, caps it); its people count against quotas, lots and per-buyer limits. The response adds `places`, `people` and `areaType`.
     # @param idempotency_key [String] Required. Reuse with the same request on retry; a different payload conflicts. Seat confirmation binds this key durably in PostgreSQL; hold mutations use bounded Redis receipts.
     # @param post_api_ga_reserve_request [PostApiGaReserveRequest] 
     # @param [Hash] opts the optional parameters
@@ -385,7 +385,7 @@ module SeatsChart
     end
 
     # Hold GA area capacity (Redis)
-    # Places a temporary hold on unnumbered GA capacity. **Idempotency-Key** is required; repeats within ~24h return the cached hold response. Optional `ticketBuyerId` is stored on the GA hold token and inherited by `POST /ga/confirm`. The organizer's booking limits cap `quantity` (designer *Max GA tickets per order*, else *Max seats per order*; strictest with the sales-channel default): 409 `booking_limit_exceeded` (`limit`, `current`, `requested`, `kind: \"ga\"`). GA tables sold as a whole (`shape.bookAs: \"whole\"`) take every place in one hold: any other `quantity` answers 409 `ga_table_whole` (`capacity`, `requested`). Areas sold as a whole (`areaType` `fixedOccupancy` / `variableOccupancy`) are held for one buyer in one piece: `quantity` is the number of people (fixed: exactly the capacity; variable: `minOccupancy`..capacity), every place of the area is held atomically and a second buyer can never hold part of it. Any other quantity answers 400 `ga_area_whole` (`areaType`, `capacity`, `minOccupancy`, `maxOccupancy`, `requested`); an area already held, sold or partly withheld answers 409 `conflict`. A whole area counts as one object against the booking limits (its capacity, at most 50, caps it); its people count against quotas, lots and per-buyer limits. The response adds `places`, `people` and `areaType`.
+    # Places a temporary hold on unnumbered GA capacity. **Idempotency-Key** is required; repeats within ~24h return the cached hold response. Optional `ticketBuyerId` is stored on the GA hold token and inherited by `POST /ga/confirm`. The organizer's booking limits cap `quantity` (designer *Max GA tickets per order*, else *Max seats per order*; strictest with the sales-channel default): 409 `booking_limit_exceeded` (`limit`, `current`, `requested`, `kind: \"ga\"`). **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. GA tables sold as a whole (`shape.bookAs: \"whole\"`) take every place in one hold: any other `quantity` answers 409 `ga_table_whole` (`capacity`, `requested`). Areas sold as a whole (`areaType` `fixedOccupancy` / `variableOccupancy`) are held for one buyer in one piece: `quantity` is the number of people (fixed: exactly the capacity; variable: `minOccupancy`..capacity), every place of the area is held atomically and a second buyer can never hold part of it. Any other quantity answers 400 `ga_area_whole` (`areaType`, `capacity`, `minOccupancy`, `maxOccupancy`, `requested`); an area already held, sold or partly withheld answers 409 `conflict`. A whole area counts as one object against the booking limits (its capacity, at most 50, caps it); its people count against quotas, lots and per-buyer limits. The response adds `places`, `people` and `areaType`.
     # @param idempotency_key [String] Required. Reuse with the same request on retry; a different payload conflicts. Seat confirmation binds this key durably in PostgreSQL; hold mutations use bounded Redis receipts.
     # @param post_api_ga_reserve_request [PostApiGaReserveRequest] 
     # @param [Hash] opts the optional parameters
@@ -621,7 +621,7 @@ module SeatsChart
     end
 
     # Suggest or atomically hold best available seats
-    # Returns seat IDs for the requested quantity, preferring adjacent same-row groups near the map center. Filter the candidate pool by `category` (or ordered `categories`, max 10: windows of the first category are tried before the second, and so on), optional `sectionId` (layout section id or name) and optional `zone` (layout zone id or name; seats resolve explicit zone assignment, then their section zone, then the zone outline) before ranking. `tryToPreventOrphanSeats` (default **true**) skips adjacent windows that would leave a single empty seat at either end of the run, falling back to them only when nothing else fits. `ticketTypes` (`{ ticketTypeId: count }`) sets `quantity` to the sum, restricts the search to categories whose ticket catalog offers every requested type, and returns `ticketTypes` (seatId → ticketTypeId) ready to send as `seatTicketTypes` on confirm; events without ticket types reject it. `accessibleSeats` (N) only returns windows containing at least N seats flagged `accessibility.wheelchair` in the published seat structure (409 when no such window exists). `channel` is salesChannel order limits only. Pass **`x-channel-key`** for inventory partitions — do not send the secret in the body. **`hold: false` (default):** suggest only — does not lock. **`hold: true`:** ranks up to 32 candidate windows across the category preferences, locks the first fit in one Lua call each (all-or-nothing per window), then O(cart) PG gates (available/forSale/channel; seats that are not for sale are never picked, not even resale-listed ones of non-propagating season members: those are bought by holding the seats of the listing); on gate failure releases only the locks it added. Requires **Idempotency-Key**, and `userId` unless `holdToken` is given. `holdToken` appends the seats to that existing hold session (same expiry bound; 409 `hold_token_conflict` when the session is expired, foreign, confirming or full). `extraData` is stored on the held seats (requires hold). Returns `hold_token` for confirm. The organizer's booking limits (designer *Max seats per order*) cap `quantity` and, with `holdToken`, the seats already on the token: best-available never picks more than allowed (409 `booking_limit_exceeded` with `limit`, `current`, `requested`). `sections` (max 20 section ids or names, XOR with `sectionId`) ranks across the union of those sections. **API keys / dashboard sessions only:** `channelKeys` (channel secret keys or ids) restricts the pool to public seats plus those channels, `ignoreChannels: true` allows every channel (both replace `x-channel-key`; buyers get 403). `orderId` (with `hold`) is stored on the held seats as `extraData.orderId` and echoed in the response; pass it as `externalOrderId` on confirm. **`status: \"booked\"`** (API keys with the `bookings` scope, or dashboard sessions allowed to change object statuses; buyers get 403) books the best window directly instead of holding it: the same administrative booking as POST /events/{eventId}/actions/book (one SQL transaction under the seat row locks; a seat held by a buyer is never taken; when a ranked window was taken meanwhile the next one is tried). Requires **Idempotency-Key**: the booking order id is derived from it, so a retry returns the same booking. `ticketTypes` are recorded per seat, `extraData` and `orderId` (as `extraData.orderId`) are stored on the booked seats. Response: `status: \"booked\"`, `booked: true`, `bookingOrderId` (cancel with POST /orders/{orderId}/cancel) and `objects` (status, extraData, orderId, ticketType per seat). `status: \"reservedByToken\"` is the same as `hold: true`. **`keepExtraData: true`** (hold or booked) keeps the seats' stored extraData and merges `extraData` / `orderId` on top instead of replacing it.
+    # Returns seat IDs for the requested quantity, preferring adjacent same-row groups near the map center. **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. Filter the candidate pool by `category` (or ordered `categories`, max 10: windows of the first category are tried before the second, and so on), optional `sectionId` (layout section id or name) and optional `zone` (layout zone id or name; seats resolve explicit zone assignment, then their section zone, then the zone outline) before ranking. `tryToPreventOrphanSeats` (default **true**) skips adjacent windows that would leave a single empty seat at either end of the run, falling back to them only when nothing else fits. `ticketTypes` (`{ ticketTypeId: count }`) sets `quantity` to the sum, restricts the search to categories whose ticket catalog offers every requested type, and returns `ticketTypes` (seatId → ticketTypeId) ready to send as `seatTicketTypes` on confirm; events without ticket types reject it. `accessibleSeats` (N) only returns windows containing at least N seats flagged `accessibility.wheelchair` in the published seat structure (409 when no such window exists). `channel` is salesChannel order limits only. Pass **`x-channel-key`** for inventory partitions — do not send the secret in the body. **`hold: false` (default):** suggest only — does not lock. **`hold: true`:** ranks up to 32 candidate windows across the category preferences, locks the first fit in one Lua call each (all-or-nothing per window), then O(cart) PG gates (available/forSale/channel; seats that are not for sale are never picked, not even resale-listed ones of non-propagating season members: those are bought by holding the seats of the listing); on gate failure releases only the locks it added. Requires **Idempotency-Key**, and `userId` unless `holdToken` is given. `holdToken` appends the seats to that existing hold session (same expiry bound; 409 `hold_token_conflict` when the session is expired, foreign, confirming or full). `extraData` is stored on the held seats (requires hold). Returns `hold_token` for confirm. The organizer's booking limits (designer *Max seats per order*) cap `quantity` and, with `holdToken`, the seats already on the token: best-available never picks more than allowed (409 `booking_limit_exceeded` with `limit`, `current`, `requested`). `sections` (max 20 section ids or names, XOR with `sectionId`) ranks across the union of those sections. **API keys / dashboard sessions only:** `channelKeys` (channel secret keys or ids) restricts the pool to public seats plus those channels, `ignoreChannels: true` allows every channel (both replace `x-channel-key`; buyers get 403). `orderId` (with `hold`) is stored on the held seats as `extraData.orderId` and echoed in the response; pass it as `externalOrderId` on confirm. **`status: \"booked\"`** (API keys with the `bookings` scope, or dashboard sessions allowed to change object statuses; buyers get 403) books the best window directly instead of holding it: the same administrative booking as POST /events/{eventId}/actions/book (one SQL transaction under the seat row locks; a seat held by a buyer is never taken; when a ranked window was taken meanwhile the next one is tried). Requires **Idempotency-Key**: the booking order id is derived from it, so a retry returns the same booking. `ticketTypes` are recorded per seat, `extraData` and `orderId` (as `extraData.orderId`) are stored on the booked seats. Response: `status: \"booked\"`, `booked: true`, `bookingOrderId` (cancel with POST /orders/{orderId}/cancel) and `objects` (status, extraData, orderId, ticketType per seat). `status: \"reservedByToken\"` is the same as `hold: true`. **`keepExtraData: true`** (hold or booked) keeps the seats' stored extraData and merges `extraData` / `orderId` on top instead of replacing it.
     # @param post_api_seats_best_available_request [PostApiSeatsBestAvailableRequest] 
     # @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.
@@ -632,7 +632,7 @@ module SeatsChart
     end
 
     # Suggest or atomically hold best available seats
-    # Returns seat IDs for the requested quantity, preferring adjacent same-row groups near the map center. Filter the candidate pool by `category` (or ordered `categories`, max 10: windows of the first category are tried before the second, and so on), optional `sectionId` (layout section id or name) and optional `zone` (layout zone id or name; seats resolve explicit zone assignment, then their section zone, then the zone outline) before ranking. `tryToPreventOrphanSeats` (default **true**) skips adjacent windows that would leave a single empty seat at either end of the run, falling back to them only when nothing else fits. `ticketTypes` (`{ ticketTypeId: count }`) sets `quantity` to the sum, restricts the search to categories whose ticket catalog offers every requested type, and returns `ticketTypes` (seatId → ticketTypeId) ready to send as `seatTicketTypes` on confirm; events without ticket types reject it. `accessibleSeats` (N) only returns windows containing at least N seats flagged `accessibility.wheelchair` in the published seat structure (409 when no such window exists). `channel` is salesChannel order limits only. Pass **`x-channel-key`** for inventory partitions — do not send the secret in the body. **`hold: false` (default):** suggest only — does not lock. **`hold: true`:** ranks up to 32 candidate windows across the category preferences, locks the first fit in one Lua call each (all-or-nothing per window), then O(cart) PG gates (available/forSale/channel; seats that are not for sale are never picked, not even resale-listed ones of non-propagating season members: those are bought by holding the seats of the listing); on gate failure releases only the locks it added. Requires **Idempotency-Key**, and `userId` unless `holdToken` is given. `holdToken` appends the seats to that existing hold session (same expiry bound; 409 `hold_token_conflict` when the session is expired, foreign, confirming or full). `extraData` is stored on the held seats (requires hold). Returns `hold_token` for confirm. The organizer's booking limits (designer *Max seats per order*) cap `quantity` and, with `holdToken`, the seats already on the token: best-available never picks more than allowed (409 `booking_limit_exceeded` with `limit`, `current`, `requested`). `sections` (max 20 section ids or names, XOR with `sectionId`) ranks across the union of those sections. **API keys / dashboard sessions only:** `channelKeys` (channel secret keys or ids) restricts the pool to public seats plus those channels, `ignoreChannels: true` allows every channel (both replace `x-channel-key`; buyers get 403). `orderId` (with `hold`) is stored on the held seats as `extraData.orderId` and echoed in the response; pass it as `externalOrderId` on confirm. **`status: \"booked\"`** (API keys with the `bookings` scope, or dashboard sessions allowed to change object statuses; buyers get 403) books the best window directly instead of holding it: the same administrative booking as POST /events/{eventId}/actions/book (one SQL transaction under the seat row locks; a seat held by a buyer is never taken; when a ranked window was taken meanwhile the next one is tried). Requires **Idempotency-Key**: the booking order id is derived from it, so a retry returns the same booking. `ticketTypes` are recorded per seat, `extraData` and `orderId` (as `extraData.orderId`) are stored on the booked seats. Response: `status: \"booked\"`, `booked: true`, `bookingOrderId` (cancel with POST /orders/{orderId}/cancel) and `objects` (status, extraData, orderId, ticketType per seat). `status: \"reservedByToken\"` is the same as `hold: true`. **`keepExtraData: true`** (hold or booked) keeps the seats' stored extraData and merges `extraData` / `orderId` on top instead of replacing it.
+    # Returns seat IDs for the requested quantity, preferring adjacent same-row groups near the map center. **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. Filter the candidate pool by `category` (or ordered `categories`, max 10: windows of the first category are tried before the second, and so on), optional `sectionId` (layout section id or name) and optional `zone` (layout zone id or name; seats resolve explicit zone assignment, then their section zone, then the zone outline) before ranking. `tryToPreventOrphanSeats` (default **true**) skips adjacent windows that would leave a single empty seat at either end of the run, falling back to them only when nothing else fits. `ticketTypes` (`{ ticketTypeId: count }`) sets `quantity` to the sum, restricts the search to categories whose ticket catalog offers every requested type, and returns `ticketTypes` (seatId → ticketTypeId) ready to send as `seatTicketTypes` on confirm; events without ticket types reject it. `accessibleSeats` (N) only returns windows containing at least N seats flagged `accessibility.wheelchair` in the published seat structure (409 when no such window exists). `channel` is salesChannel order limits only. Pass **`x-channel-key`** for inventory partitions — do not send the secret in the body. **`hold: false` (default):** suggest only — does not lock. **`hold: true`:** ranks up to 32 candidate windows across the category preferences, locks the first fit in one Lua call each (all-or-nothing per window), then O(cart) PG gates (available/forSale/channel; seats that are not for sale are never picked, not even resale-listed ones of non-propagating season members: those are bought by holding the seats of the listing); on gate failure releases only the locks it added. Requires **Idempotency-Key**, and `userId` unless `holdToken` is given. `holdToken` appends the seats to that existing hold session (same expiry bound; 409 `hold_token_conflict` when the session is expired, foreign, confirming or full). `extraData` is stored on the held seats (requires hold). Returns `hold_token` for confirm. The organizer's booking limits (designer *Max seats per order*) cap `quantity` and, with `holdToken`, the seats already on the token: best-available never picks more than allowed (409 `booking_limit_exceeded` with `limit`, `current`, `requested`). `sections` (max 20 section ids or names, XOR with `sectionId`) ranks across the union of those sections. **API keys / dashboard sessions only:** `channelKeys` (channel secret keys or ids) restricts the pool to public seats plus those channels, `ignoreChannels: true` allows every channel (both replace `x-channel-key`; buyers get 403). `orderId` (with `hold`) is stored on the held seats as `extraData.orderId` and echoed in the response; pass it as `externalOrderId` on confirm. **`status: \"booked\"`** (API keys with the `bookings` scope, or dashboard sessions allowed to change object statuses; buyers get 403) books the best window directly instead of holding it: the same administrative booking as POST /events/{eventId}/actions/book (one SQL transaction under the seat row locks; a seat held by a buyer is never taken; when a ranked window was taken meanwhile the next one is tried). Requires **Idempotency-Key**: the booking order id is derived from it, so a retry returns the same booking. `ticketTypes` are recorded per seat, `extraData` and `orderId` (as `extraData.orderId`) are stored on the booked seats. Response: `status: \"booked\"`, `booked: true`, `bookingOrderId` (cancel with POST /orders/{orderId}/cancel) and `objects` (status, extraData, orderId, ticketType per seat). `status: \"reservedByToken\"` is the same as `hold: true`. **`keepExtraData: true`** (hold or booked) keeps the seats' stored extraData and merges `extraData` / `orderId` on top instead of replacing it.
     # @param post_api_seats_best_available_request [PostApiSeatsBestAvailableRequest] 
     # @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.
@@ -1006,7 +1006,7 @@ module SeatsChart
     end
 
     # Place a temporary Redis hold (Lua TTL) before payment
-    # JSON body: `eventId`, `seatIds` (1–64 UUIDs, unique; up to the workspace `maxSeatsPerHoldToken` with large group holds), `userId`, optional `holdToken` capability to append seats to an existing session. `userId` is customer metadata, never ownership proof. Renew/append share a two-hour maximum session lifetime. Optional `ticketBuyerId` (opaque partner buyer id) is stored on a new hold token and inherited by its confirmation. `eventId` also accepts the event key. Headers: **x-api-key** (B2B) *or* **Authorization: Bearer** (HS256 JWT); optional **x-tenant-id**; **`Idempotency-Key` is required** (1–255 chars after trim; use a fresh UUID v4 per checkout attempt). Repeats with the same key within ~24h return the cached HTTP status and JSON without re-running the Lua lock. Applies Redis TTL locks (**default 600 s**, overridden by **`SEAT_HOLD_TTL_SEC`**, or by the workspace **hold period** setting — `PATCH /workspace/settings`) with SSE `seat` → **`locked`**; Postgres remains **`available`** until **`POST /api/seats/confirm`** persists **`sold`** via the reservation worker. A hold token holds at most the workspace `maxSeatsPerHoldToken` seats (409 `seat_limit`). **Large group holds (opt-in):** a workspace `maxSeatsPerHoldToken` above 64 (up to 1000, `PATCH /workspace/settings`) lets one request and one hold token hold that many seats of one event; the request is still one atomic lock — every seat of the group is held under the token, or none is (409 `SEAT_LOCKED` when any seat is taken, nothing locked). The sales-channel defaults (web 8, box office 20, partner 64) then step aside; the organizer's booking limits and the workspace cap still apply. Season and multi-event holds keep the 64-lock limit. **Booking limits:** the organizer's *Max seats per order* (designer → Booking limits, stored as `layoutMeta.bookingRules` of the published chart/event layout) caps the seats one hold token holds, appends included, checked in the same atomic call as the locks (parallel appends cannot exceed it); the strictest of the sales-channel default, this limit, the per-buyer limit and `maxSeatsPerHoldToken` wins. Refused with 409 `booking_limit_exceeded` (`limit`, `current` seats already on the token, `requested`, `kind: \"seats\"`). Holds placed before a lower limit was published keep their seats and stay confirmable; they only cannot grow. With ticket buyer validation on, buyer tokens must carry a bound ticket buyer id (403 `ticket_buyer_required` / `ticket_buyer_mismatch`). Seats that are not for sale are refused with 409 `SEAT_NOT_FOR_SALE`, except a seat with an active **resale** listing in a season member whose for-sale configuration does not propagate (`forSalePropagated: false`, e.g. a season-ticket seat its holder resells for one game); the confirmation and the order commit apply the same rule.
+    # JSON body: `eventId`, `seatIds` (1–64 UUIDs, unique; up to the workspace `maxSeatsPerHoldToken` with large group holds), `userId`, optional `holdToken` capability to append seats to an existing session. `userId` is customer metadata, never ownership proof. Renew/append share a two-hour maximum session lifetime. Optional `ticketBuyerId` (opaque partner buyer id) is stored on a new hold token and inherited by its confirmation. `eventId` also accepts the event key. Headers: **x-api-key** (B2B) *or* **Authorization: Bearer** (HS256 JWT); optional **x-tenant-id**; **`Idempotency-Key` is required** (1–255 chars after trim; use a fresh UUID v4 per checkout attempt). Repeats with the same key within ~24h return the cached HTTP status and JSON without re-running the Lua lock. Applies Redis TTL locks (**default 600 s**, overridden by **`SEAT_HOLD_TTL_SEC`**, or by the workspace **hold period** setting — `PATCH /workspace/settings`) with SSE `seat` → **`locked`**; Postgres remains **`available`** until **`POST /api/seats/confirm`** persists **`sold`** via the reservation worker. A hold token holds at most the workspace `maxSeatsPerHoldToken` seats (409 `seat_limit`). **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. **Large group holds (opt-in):** a workspace `maxSeatsPerHoldToken` above 64 (up to 1000, `PATCH /workspace/settings`) lets one request and one hold token hold that many seats of one event; the request is still one atomic lock — every seat of the group is held under the token, or none is (409 `SEAT_LOCKED` when any seat is taken, nothing locked). The sales-channel defaults (web 8, box office 20, partner 64) then step aside; the organizer's booking limits and the workspace cap still apply. Season and multi-event holds keep the 64-lock limit. **Booking limits:** the organizer's *Max seats per order* (designer → Booking limits, stored as `layoutMeta.bookingRules` of the published chart/event layout) caps the seats one hold token holds, appends included, checked in the same atomic call as the locks (parallel appends cannot exceed it); the strictest of the sales-channel default, this limit, the per-buyer limit and `maxSeatsPerHoldToken` wins. Refused with 409 `booking_limit_exceeded` (`limit`, `current` seats already on the token, `requested`, `kind: \"seats\"`). Holds placed before a lower limit was published keep their seats and stay confirmable; they only cannot grow. With ticket buyer validation on, buyer tokens must carry a bound ticket buyer id (403 `ticket_buyer_required` / `ticket_buyer_mismatch`). Seats that are not for sale are refused with 409 `SEAT_NOT_FOR_SALE`, except a seat with an active **resale** listing in a season member whose for-sale configuration does not propagate (`forSalePropagated: false`, e.g. a season-ticket seat its holder resells for one game); the confirmation and the order commit apply the same rule.
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim; UUID v4 recommended). 24h idempotent cache replay in Redis per tenant.
     # @param post_api_seats_reserve_request [PostApiSeatsReserveRequest] 
     # @param [Hash] opts the optional parameters
@@ -1018,7 +1018,7 @@ module SeatsChart
     end
 
     # Place a temporary Redis hold (Lua TTL) before payment
-    # JSON body: `eventId`, `seatIds` (1–64 UUIDs, unique; up to the workspace `maxSeatsPerHoldToken` with large group holds), `userId`, optional `holdToken` capability to append seats to an existing session. `userId` is customer metadata, never ownership proof. Renew/append share a two-hour maximum session lifetime. Optional `ticketBuyerId` (opaque partner buyer id) is stored on a new hold token and inherited by its confirmation. `eventId` also accepts the event key. Headers: **x-api-key** (B2B) *or* **Authorization: Bearer** (HS256 JWT); optional **x-tenant-id**; **`Idempotency-Key` is required** (1–255 chars after trim; use a fresh UUID v4 per checkout attempt). Repeats with the same key within ~24h return the cached HTTP status and JSON without re-running the Lua lock. Applies Redis TTL locks (**default 600 s**, overridden by **`SEAT_HOLD_TTL_SEC`**, or by the workspace **hold period** setting — `PATCH /workspace/settings`) with SSE `seat` → **`locked`**; Postgres remains **`available`** until **`POST /api/seats/confirm`** persists **`sold`** via the reservation worker. A hold token holds at most the workspace `maxSeatsPerHoldToken` seats (409 `seat_limit`). **Large group holds (opt-in):** a workspace `maxSeatsPerHoldToken` above 64 (up to 1000, `PATCH /workspace/settings`) lets one request and one hold token hold that many seats of one event; the request is still one atomic lock — every seat of the group is held under the token, or none is (409 `SEAT_LOCKED` when any seat is taken, nothing locked). The sales-channel defaults (web 8, box office 20, partner 64) then step aside; the organizer's booking limits and the workspace cap still apply. Season and multi-event holds keep the 64-lock limit. **Booking limits:** the organizer's *Max seats per order* (designer → Booking limits, stored as `layoutMeta.bookingRules` of the published chart/event layout) caps the seats one hold token holds, appends included, checked in the same atomic call as the locks (parallel appends cannot exceed it); the strictest of the sales-channel default, this limit, the per-buyer limit and `maxSeatsPerHoldToken` wins. Refused with 409 `booking_limit_exceeded` (`limit`, `current` seats already on the token, `requested`, `kind: \"seats\"`). Holds placed before a lower limit was published keep their seats and stay confirmable; they only cannot grow. With ticket buyer validation on, buyer tokens must carry a bound ticket buyer id (403 `ticket_buyer_required` / `ticket_buyer_mismatch`). Seats that are not for sale are refused with 409 `SEAT_NOT_FOR_SALE`, except a seat with an active **resale** listing in a season member whose for-sale configuration does not propagate (`forSalePropagated: false`, e.g. a season-ticket seat its holder resells for one game); the confirmation and the order commit apply the same rule.
+    # JSON body: `eventId`, `seatIds` (1–64 UUIDs, unique; up to the workspace `maxSeatsPerHoldToken` with large group holds), `userId`, optional `holdToken` capability to append seats to an existing session. `userId` is customer metadata, never ownership proof. Renew/append share a two-hour maximum session lifetime. Optional `ticketBuyerId` (opaque partner buyer id) is stored on a new hold token and inherited by its confirmation. `eventId` also accepts the event key. Headers: **x-api-key** (B2B) *or* **Authorization: Bearer** (HS256 JWT); optional **x-tenant-id**; **`Idempotency-Key` is required** (1–255 chars after trim; use a fresh UUID v4 per checkout attempt). Repeats with the same key within ~24h return the cached HTTP status and JSON without re-running the Lua lock. Applies Redis TTL locks (**default 600 s**, overridden by **`SEAT_HOLD_TTL_SEC`**, or by the workspace **hold period** setting — `PATCH /workspace/settings`) with SSE `seat` → **`locked`**; Postgres remains **`available`** until **`POST /api/seats/confirm`** persists **`sold`** via the reservation worker. A hold token holds at most the workspace `maxSeatsPerHoldToken` seats (409 `seat_limit`). **Free (test plan) out of seats:** once the workspace used its 50 seats of the month, new holds (appends included) answer 409 `holds_paused` with a neutral message until the next UTC month or an upgrade; holds already taken can still be confirmed. **Large group holds (opt-in):** a workspace `maxSeatsPerHoldToken` above 64 (up to 1000, `PATCH /workspace/settings`) lets one request and one hold token hold that many seats of one event; the request is still one atomic lock — every seat of the group is held under the token, or none is (409 `SEAT_LOCKED` when any seat is taken, nothing locked). The sales-channel defaults (web 8, box office 20, partner 64) then step aside; the organizer's booking limits and the workspace cap still apply. Season and multi-event holds keep the 64-lock limit. **Booking limits:** the organizer's *Max seats per order* (designer → Booking limits, stored as `layoutMeta.bookingRules` of the published chart/event layout) caps the seats one hold token holds, appends included, checked in the same atomic call as the locks (parallel appends cannot exceed it); the strictest of the sales-channel default, this limit, the per-buyer limit and `maxSeatsPerHoldToken` wins. Refused with 409 `booking_limit_exceeded` (`limit`, `current` seats already on the token, `requested`, `kind: \"seats\"`). Holds placed before a lower limit was published keep their seats and stay confirmable; they only cannot grow. With ticket buyer validation on, buyer tokens must carry a bound ticket buyer id (403 `ticket_buyer_required` / `ticket_buyer_mismatch`). Seats that are not for sale are refused with 409 `SEAT_NOT_FOR_SALE`, except a seat with an active **resale** listing in a season member whose for-sale configuration does not propagate (`forSalePropagated: false`, e.g. a season-ticket seat its holder resells for one game); the confirmation and the order commit apply the same rule.
     # @param idempotency_key [String] Required deduplication key (max 255 chars after trim; UUID v4 recommended). 24h idempotent cache replay in Redis per tenant.
     # @param post_api_seats_reserve_request [PostApiSeatsReserveRequest] 
     # @param [Hash] opts the optional parameters

data/lib/seatschart/api/usage_api.rb

@@ -87,7 +87,7 @@ module SeatsChart
     end
 
     # Monthly usage: used objects, charts and events
-    # Sandboxes (`isTest: true`) are metered so their usage can be seen, but never billed and never held to plan limits (`limit: null`). `usedObjects.count` is the number of distinct objects booked in the UTC calendar month (seats.io-style billing unit): every seat that became booked counts once per month however often it is retried, released and re-booked; each sold general-admission place counts as one. Holds, test events and replays never count. Map-only renders (`bringYourOwnBackend`) count every object of the rendered chart once per chart and month (`byEvent` entry with the chart id and `mapOnly: true`). `history` has exactly 12 months ending at `month` (zero-filled); `byEvent` lists the top 100 events of the month. `charts`/`events` are current totals against the plan limits. Dashboard JWT (any role) or an API key with the `reports` scope.
+    # Sandboxes (`isTest: true`) are metered so their usage can be seen, but never billed and never held to plan limits (`limit: null`). `usedObjects.count` is the number of distinct objects booked in the UTC calendar month (seats.io-style billing unit): every seat that became booked counts once per month however often it is retried, released and re-booked; each sold general-admission place counts as one. Holds, test events and replays never count. Map-only renders (`bringYourOwnBackend`) count every object of the rendered chart once per chart and month (`byEvent` entry with the chart id and `mapOnly: true`). `history` has exactly 12 months ending at `month` (zero-filled); `byEvent` lists the top 100 events of the month. `charts`/`events` are this workspace's current totals; the plan limits count every production workspace of the billing account together (`account.charts` / `account.events`). `account`: the billing account the workspace belongs to (one plan for all its workspaces) with `ownerEmail`, `isOwner`, `workspaceCount` and the account totals `charts`, `events` and `usedSeats` of the month; `null` in a sandbox or without an account. `seats`: the used seats (the billing unit: one per event, object and month; the same seat sold in two events counts twice) of the billing account in the month — every production workspace of the account, an organizer workspace of a ticketing platform with the platform — with `includedSeats`, `mode` (`overage`: paid plan, extra seats billed per seat; `allowance`: Free, new events and putting events on sale pause above it; `on_demand`: Ultra On-Demand, every seat billed by the SeatsChart team), `overage` { seats, costCents } so far, `projected` (current month at the current pace) and `allowanceExceeded`; `null` in a test workspace. Dashboard JWT (any role) or an API key with the `reports` scope.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :month UTC calendar month `YYYY-MM` (default: current month).
     # @return [nil]
@@ -97,7 +97,7 @@ module SeatsChart
     end
 
     # Monthly usage: used objects, charts and events
-    # Sandboxes (`isTest: true`) are metered so their usage can be seen, but never billed and never held to plan limits (`limit: null`). `usedObjects.count` is the number of distinct objects booked in the UTC calendar month (seats.io-style billing unit): every seat that became booked counts once per month however often it is retried, released and re-booked; each sold general-admission place counts as one. Holds, test events and replays never count. Map-only renders (`bringYourOwnBackend`) count every object of the rendered chart once per chart and month (`byEvent` entry with the chart id and `mapOnly: true`). `history` has exactly 12 months ending at `month` (zero-filled); `byEvent` lists the top 100 events of the month. `charts`/`events` are current totals against the plan limits. Dashboard JWT (any role) or an API key with the `reports` scope.
+    # Sandboxes (`isTest: true`) are metered so their usage can be seen, but never billed and never held to plan limits (`limit: null`). `usedObjects.count` is the number of distinct objects booked in the UTC calendar month (seats.io-style billing unit): every seat that became booked counts once per month however often it is retried, released and re-booked; each sold general-admission place counts as one. Holds, test events and replays never count. Map-only renders (`bringYourOwnBackend`) count every object of the rendered chart once per chart and month (`byEvent` entry with the chart id and `mapOnly: true`). `history` has exactly 12 months ending at `month` (zero-filled); `byEvent` lists the top 100 events of the month. `charts`/`events` are this workspace's current totals; the plan limits count every production workspace of the billing account together (`account.charts` / `account.events`). `account`: the billing account the workspace belongs to (one plan for all its workspaces) with `ownerEmail`, `isOwner`, `workspaceCount` and the account totals `charts`, `events` and `usedSeats` of the month; `null` in a sandbox or without an account. `seats`: the used seats (the billing unit: one per event, object and month; the same seat sold in two events counts twice) of the billing account in the month — every production workspace of the account, an organizer workspace of a ticketing platform with the platform — with `includedSeats`, `mode` (`overage`: paid plan, extra seats billed per seat; `allowance`: Free, new events and putting events on sale pause above it; `on_demand`: Ultra On-Demand, every seat billed by the SeatsChart team), `overage` { seats, costCents } so far, `projected` (current month at the current pace) and `allowanceExceeded`; `null` in a test workspace. Dashboard JWT (any role) or an API key with the `reports` scope.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :month UTC calendar month `YYYY-MM` (default: current month).
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -478,7 +478,7 @@ module SeatsChart
     end
 
     # Monthly used objects across my workspaces (admin view)
-    # Every workspace the caller administers (role admin), with its plan, status and used objects of the month against the plan limit (`null` for sandboxes, which are metered but never billed), plus the total of the production workspaces (`usedObjects`) and, separately, of the sandboxes (`sandboxUsedObjects`). Dashboard session, or a **workspace admin API key** (the admin it is bound to); other API keys: 403 `ERR_PARTNER_SCOPE`. One grouped read of the metering table.
+    # Every workspace the caller administers (role admin), with its plan, status and used objects of the month against the plan limit (`null` for sandboxes, which are metered but never billed), plus the total of the production workspaces (`usedObjects`) and, separately, of the sandboxes (`sandboxUsedObjects`). Each item names its billing account (`billingOwnerUserId`); `accounts` lists those accounts (the caller's own first) with the owner, the plan and the totals of every production workspace of the account (`workspaceCount`, `charts`, `events`, `usedObjects` against the plan's included seats), since one plan covers them all. Dashboard session, or a **workspace admin API key** (the admin it is bound to); other API keys: 403 `ERR_PARTNER_SCOPE`. One grouped read of the metering table.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :month UTC calendar month &#x60;YYYY-MM&#x60; (default: current month).
     # @return [nil]
@@ -488,7 +488,7 @@ module SeatsChart
     end
 
     # Monthly used objects across my workspaces (admin view)
-    # Every workspace the caller administers (role admin), with its plan, status and used objects of the month against the plan limit (&#x60;null&#x60; for sandboxes, which are metered but never billed), plus the total of the production workspaces (&#x60;usedObjects&#x60;) and, separately, of the sandboxes (&#x60;sandboxUsedObjects&#x60;). Dashboard session, or a **workspace admin API key** (the admin it is bound to); other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;. One grouped read of the metering table.
+    # Every workspace the caller administers (role admin), with its plan, status and used objects of the month against the plan limit (&#x60;null&#x60; for sandboxes, which are metered but never billed), plus the total of the production workspaces (&#x60;usedObjects&#x60;) and, separately, of the sandboxes (&#x60;sandboxUsedObjects&#x60;). Each item names its billing account (&#x60;billingOwnerUserId&#x60;); &#x60;accounts&#x60; lists those accounts (the caller&#39;s own first) with the owner, the plan and the totals of every production workspace of the account (&#x60;workspaceCount&#x60;, &#x60;charts&#x60;, &#x60;events&#x60;, &#x60;usedObjects&#x60; against the plan&#39;s included seats), since one plan covers them all. Dashboard session, or a **workspace admin API key** (the admin it is bound to); other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;. One grouped read of the metering table.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :month UTC calendar month &#x60;YYYY-MM&#x60; (default: current month).
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers

data/lib/seatschart/api/workspace_api.rb

@@ -107,10 +107,10 @@ module SeatsChart
     # @param invitation_id [String] 
     # @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]
+    # @return [DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response]
     def delete_api_workspaces_by_workspace_id_invitations_by_invitation_id(workspace_id, invitation_id, opts = {})
-      delete_api_workspaces_by_workspace_id_invitations_by_invitation_id_with_http_info(workspace_id, invitation_id, opts)
-      nil
+      data, _status_code, _headers = delete_api_workspaces_by_workspace_id_invitations_by_invitation_id_with_http_info(workspace_id, invitation_id, opts)
+      data
     end
 
     # Revoke a pending invitation of a workspace you administer
@@ -119,7 +119,7 @@ module SeatsChart
     # @param invitation_id [String] 
     # @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
+    # @return [Array<(DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response, Integer, Hash)>] DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response data, response status code and response headers
     def delete_api_workspaces_by_workspace_id_invitations_by_invitation_id_with_http_info(workspace_id, invitation_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.delete_api_workspaces_by_workspace_id_invitations_by_invitation_id ...'
@@ -156,6 +156,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
       header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
@@ -165,7 +167,7 @@ module SeatsChart
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
@@ -281,10 +283,10 @@ module SeatsChart
     # @param user_id [String] 
     # @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]
+    # @return [DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response]
     def delete_api_workspaces_by_workspace_id_members_by_user_id(workspace_id, user_id, opts = {})
-      delete_api_workspaces_by_workspace_id_members_by_user_id_with_http_info(workspace_id, user_id, opts)
-      nil
+      data, _status_code, _headers = delete_api_workspaces_by_workspace_id_members_by_user_id_with_http_info(workspace_id, user_id, opts)
+      data
     end
 
     # Remove a member from a workspace you administer
@@ -293,7 +295,7 @@ module SeatsChart
     # @param user_id [String] 
     # @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
+    # @return [Array<(DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response, Integer, Hash)>] DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response data, response status code and response headers
     def delete_api_workspaces_by_workspace_id_members_by_user_id_with_http_info(workspace_id, user_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.delete_api_workspaces_by_workspace_id_members_by_user_id ...'
@@ -330,6 +332,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
       header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
@@ -339,7 +343,7 @@ module SeatsChart
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'DeleteApiWorkspacesByWorkspaceIdMembersByUserId200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
@@ -705,7 +709,7 @@ module SeatsChart
     # @option opts [String] :filter Case-insensitive substring of the workspace name or id (seats.io &#x60;filter&#x60;).
     # @option opts [String] :status &#x60;active&#x60; (seats.io listActive), &#x60;inactive&#x60; (deactivated; seats.io listInactive) or &#x60;all&#x60; (default).
     # @option opts [String] :external_id Only the workspace with this external id (your organizer id; exact match).
-    # @option opts [GetApiWorkspacesCreatedByApiParameter] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key; &#x60;false&#x60;: only the others.
     # @return [GetApiWorkspaces200Response]
     def get_api_workspaces(opts = {})
       data, _status_code, _headers = get_api_workspaces_with_http_info(opts)
@@ -718,7 +722,7 @@ module SeatsChart
     # @option opts [String] :filter Case-insensitive substring of the workspace name or id (seats.io &#x60;filter&#x60;).
     # @option opts [String] :status &#x60;active&#x60; (seats.io listActive), &#x60;inactive&#x60; (deactivated; seats.io listInactive) or &#x60;all&#x60; (default).
     # @option opts [String] :external_id Only the workspace with this external id (your organizer id; exact match).
-    # @option opts [GetApiWorkspacesCreatedByApiParameter] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key; &#x60;false&#x60;: only the others.
     # @return [Array<(GetApiWorkspaces200Response, Integer, Hash)>] GetApiWorkspaces200Response data, response status code and response headers
     def get_api_workspaces_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -943,16 +947,16 @@ module SeatsChart
     # List the pending invitations of a workspace you administer
     # @param workspace_id [String] Workspace id or its external id.
     # @param [Hash] opts the optional parameters
-    # @return [nil]
+    # @return [GetApiWorkspacesByWorkspaceIdInvitations200Response]
     def get_api_workspaces_by_workspace_id_invitations(workspace_id, opts = {})
-      get_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, opts)
-      nil
+      data, _status_code, _headers = get_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, opts)
+      data
     end
 
     # List the pending invitations of a workspace you administer
     # @param workspace_id [String] Workspace id or its external id.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    # @return [Array<(GetApiWorkspacesByWorkspaceIdInvitations200Response, Integer, Hash)>] GetApiWorkspacesByWorkspaceIdInvitations200Response data, response status code and response headers
     def get_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.get_api_workspaces_by_workspace_id_invitations ...'
@@ -977,6 +981,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -985,7 +991,7 @@ module SeatsChart
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'GetApiWorkspacesByWorkspaceIdInvitations200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
@@ -1082,17 +1088,17 @@ module SeatsChart
     # Dashboard members with role, join date and `twoFactorEnabled`. Dashboard session or a workspace admin API key.
     # @param workspace_id [String] Workspace id or its external id.
     # @param [Hash] opts the optional parameters
-    # @return [nil]
+    # @return [GetApiWorkspacesByWorkspaceIdMembers200Response]
     def get_api_workspaces_by_workspace_id_members(workspace_id, opts = {})
-      get_api_workspaces_by_workspace_id_members_with_http_info(workspace_id, opts)
-      nil
+      data, _status_code, _headers = get_api_workspaces_by_workspace_id_members_with_http_info(workspace_id, opts)
+      data
     end
 
     # List the members of a workspace you administer
     # Dashboard members with role, join date and &#x60;twoFactorEnabled&#x60;. Dashboard session or a workspace admin API key.
     # @param workspace_id [String] Workspace id or its external id.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    # @return [Array<(GetApiWorkspacesByWorkspaceIdMembers200Response, Integer, Hash)>] GetApiWorkspacesByWorkspaceIdMembers200Response data, response status code and response headers
     def get_api_workspaces_by_workspace_id_members_with_http_info(workspace_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.get_api_workspaces_by_workspace_id_members ...'
@@ -1117,6 +1123,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1125,7 +1133,7 @@ module SeatsChart
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'GetApiWorkspacesByWorkspaceIdMembers200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
@@ -1148,34 +1156,34 @@ module SeatsChart
     end
 
     # Consolidated overview of the organizer workspaces you administer
-    # One call for the platform view: every production workspace the caller administers (for a workspace admin key: its admin), newest first, with charts (not archived), events, seats `sold` / `held` / `available` (numbered seats for sale plus general admission places; held = numbered seats under a hold now, read from Redis for current and upcoming events), `revenue` and the used objects of `month`, plus `totals` over every workspace matching the filters (not only this page). `revenue.cents` is the catalog price of the sold seats and is known only when the workspace takes prices from SeatsChart (`pricingSource: seatschart_catalog`); with partner or synced pricing the platform owns the amounts (`known: false`, `cents: null`; `totals.revenue.complete` says whether every workspace was known). Sold and available come from PostgreSQL, holds from Redis. Filters: `externalId`, `status`, `createdByApi`, creation date range `createdFrom` / `createdTo`. Paginated with `limit` / `nextCursor`. Dashboard session or a workspace admin API key.
+    # One call for the platform view: every production workspace the caller administers (for a workspace admin key: its admin), newest first, with charts (not archived), events, seats `sold` / `held` / `available` (numbered seats for sale plus general admission places; held = numbered seats under a hold now, read from Redis for current and upcoming events), `revenue` and the used objects of `month`, plus `totals` over every workspace matching the filters (not only this page). `revenue.cents` is the catalog price of the sold seats and is known only when the workspace takes prices from SeatsChart (`pricingSource: seatschart_catalog`); with partner or synced pricing the platform owns the amounts (`known: false`, `cents: null`; `totals.revenue.complete` says whether every workspace was known). Sold and available come from PostgreSQL, holds from Redis. `usage.usedSeats` is each workspace's used seats of the month (the billing unit) and `usage.projectedSeats` its projection at the current pace. `seats` is the seat billing of the caller's billing account for the month: the seats of every production workspace of the account (its own and the organizer workspaces it provisioned) together, against the account's plan (`includedSeats`, `overage` and `projected` with their cost); `account` holds the account's totals (`workspaceCount`, `plan`, `charts` and `events` against the plan caps, which count them together); both `null` when the caller has no billing account. Filters: `externalId`, `status`, `createdByApi`, creation date range `createdFrom` / `createdTo`. Paginated with `limit` / `nextCursor`. Dashboard session or a workspace admin API key.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :external_id Only this organizer.
     # @option opts [String] :status Default &#x60;all&#x60;.
-    # @option opts [GetApiWorkspacesOverviewCreatedByApiParameter] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key.
+    # @option opts [Boolean] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key.
     # @option opts [String] :created_from Workspaces created at or after this date / date-time (ISO 8601).
     # @option opts [String] :created_to Workspaces created at or before this date (whole UTC day) / date-time.
     # @option opts [String] :month Usage month &#x60;YYYY-MM&#x60; (default: the current UTC month).
     # @option opts [Float] :limit Page size (1..200, default 50).
     # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; of the previous page.
-    # @return [nil]
+    # @return [GetApiWorkspacesOverview200Response]
     def get_api_workspaces_overview(opts = {})
-      get_api_workspaces_overview_with_http_info(opts)
-      nil
+      data, _status_code, _headers = get_api_workspaces_overview_with_http_info(opts)
+      data
     end
 
     # Consolidated overview of the organizer workspaces you administer
-    # One call for the platform view: every production workspace the caller administers (for a workspace admin key: its admin), newest first, with charts (not archived), events, seats &#x60;sold&#x60; / &#x60;held&#x60; / &#x60;available&#x60; (numbered seats for sale plus general admission places; held &#x3D; numbered seats under a hold now, read from Redis for current and upcoming events), &#x60;revenue&#x60; and the used objects of &#x60;month&#x60;, plus &#x60;totals&#x60; over every workspace matching the filters (not only this page). &#x60;revenue.cents&#x60; is the catalog price of the sold seats and is known only when the workspace takes prices from SeatsChart (&#x60;pricingSource: seatschart_catalog&#x60;); with partner or synced pricing the platform owns the amounts (&#x60;known: false&#x60;, &#x60;cents: null&#x60;; &#x60;totals.revenue.complete&#x60; says whether every workspace was known). Sold and available come from PostgreSQL, holds from Redis. Filters: &#x60;externalId&#x60;, &#x60;status&#x60;, &#x60;createdByApi&#x60;, creation date range &#x60;createdFrom&#x60; / &#x60;createdTo&#x60;. Paginated with &#x60;limit&#x60; / &#x60;nextCursor&#x60;. Dashboard session or a workspace admin API key.
+    # One call for the platform view: every production workspace the caller administers (for a workspace admin key: its admin), newest first, with charts (not archived), events, seats &#x60;sold&#x60; / &#x60;held&#x60; / &#x60;available&#x60; (numbered seats for sale plus general admission places; held &#x3D; numbered seats under a hold now, read from Redis for current and upcoming events), &#x60;revenue&#x60; and the used objects of &#x60;month&#x60;, plus &#x60;totals&#x60; over every workspace matching the filters (not only this page). &#x60;revenue.cents&#x60; is the catalog price of the sold seats and is known only when the workspace takes prices from SeatsChart (&#x60;pricingSource: seatschart_catalog&#x60;); with partner or synced pricing the platform owns the amounts (&#x60;known: false&#x60;, &#x60;cents: null&#x60;; &#x60;totals.revenue.complete&#x60; says whether every workspace was known). Sold and available come from PostgreSQL, holds from Redis. &#x60;usage.usedSeats&#x60; is each workspace&#39;s used seats of the month (the billing unit) and &#x60;usage.projectedSeats&#x60; its projection at the current pace. &#x60;seats&#x60; is the seat billing of the caller&#39;s billing account for the month: the seats of every production workspace of the account (its own and the organizer workspaces it provisioned) together, against the account&#39;s plan (&#x60;includedSeats&#x60;, &#x60;overage&#x60; and &#x60;projected&#x60; with their cost); &#x60;account&#x60; holds the account&#39;s totals (&#x60;workspaceCount&#x60;, &#x60;plan&#x60;, &#x60;charts&#x60; and &#x60;events&#x60; against the plan caps, which count them together); both &#x60;null&#x60; when the caller has no billing account. Filters: &#x60;externalId&#x60;, &#x60;status&#x60;, &#x60;createdByApi&#x60;, creation date range &#x60;createdFrom&#x60; / &#x60;createdTo&#x60;. Paginated with &#x60;limit&#x60; / &#x60;nextCursor&#x60;. Dashboard session or a workspace admin API key.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :external_id Only this organizer.
     # @option opts [String] :status Default &#x60;all&#x60;.
-    # @option opts [GetApiWorkspacesOverviewCreatedByApiParameter] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key.
+    # @option opts [Boolean] :created_by_api &#x60;true&#x60;: only workspaces provisioned by a workspace admin key.
     # @option opts [String] :created_from Workspaces created at or after this date / date-time (ISO 8601).
     # @option opts [String] :created_to Workspaces created at or before this date (whole UTC day) / date-time.
     # @option opts [String] :month Usage month &#x60;YYYY-MM&#x60; (default: the current UTC month).
     # @option opts [Float] :limit Page size (1..200, default 50).
     # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; of the previous page.
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    # @return [Array<(GetApiWorkspacesOverview200Response, Integer, Hash)>] GetApiWorkspacesOverview200Response data, response status code and response headers
     def get_api_workspaces_overview_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.get_api_workspaces_overview ...'
@@ -1255,6 +1263,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1263,7 +1273,7 @@ module SeatsChart
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'GetApiWorkspacesOverview200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
@@ -1927,7 +1937,7 @@ module SeatsChart
     end
 
     # Create a workspace (provision an organizer)
-    # Provisions a workspace and admin membership for the caller: a dashboard admin session, or a **full-access workspace admin API key** (`POST /api/keys` with `workspaceAdmin: true`), whose bound admin becomes the admin of the new workspace. Other API keys: 403 `ERR_PARTNER_SCOPE`.  **Ticketing platforms (one workspace per organizer):** send `externalId` (your organizer id), `templateWorkspaceId` (a workspace whose integration settings, embed domains and webhooks to copy) and `issueKey` (mint the organizer's API key in the same call). A workspace created by a workspace admin key is marked `createdByApi`, starts on the platform account plan (`default_plan_id` of the admin, e.g. Ultra On-Demand) and is billed to the platform: its members never see checkout or upgrade prompts. Without a template it starts with partner pricing and the platform defaults. Then call any partner route in it with the same admin key and `X-Workspace-Key: <workspaceId or externalId>`.  **Idempotency:** send `Idempotency-Key` (1–255 characters): the same key and body within 24 hours returns the first result with `idempotentReplay: true` and every secret `null` (secrets are never stored; rotate the key if the first response was lost). The same key with another body: 422 `idempotency_key_reused`; while the first call still runs: 409.  `isTest: true` creates a test workspace linked to the current production workspace (`parentWorkspaceId`), optionally copying its charts (`copyCharts`). Written to the audit log of the current workspace (`workspace.create` / `workspace.create_test`) and, for a production workspace, of the new one. Returns a new `publicKey`: not a secret and not a Bearer substitute.
+    # Provisions a workspace and admin membership for the caller: a dashboard admin session, or a **full-access workspace admin API key** (`POST /api/keys` with `workspaceAdmin: true`), whose bound admin becomes the admin of the new workspace. Other API keys: 403 `ERR_PARTNER_SCOPE`.  **Ticketing platforms (one workspace per organizer):** send `externalId` (your organizer id), `templateWorkspaceId` (a workspace whose integration settings, embed domains and webhooks to copy) and `issueKey` (mint the organizer's API key in the same call). A workspace created by a workspace admin key is marked `createdByApi`, joins the platform admin's billing account (one plan for every workspace of the account, e.g. Ultra On-Demand: its charts, events and seats count with the others) and is billed to the platform: its members never see checkout or upgrade prompts. A workspace created in the dashboard joins the creator's billing account the same way, and a sandbox its parent's. Without a template it starts with partner pricing and the platform defaults. Then call any partner route in it with the same admin key and `X-Workspace-Key: <workspaceId or externalId>`.  **Idempotency:** send `Idempotency-Key` (1–255 characters): the same key and body within 24 hours returns the first result with `idempotentReplay: true` and every secret `null` (secrets are never stored; rotate the key if the first response was lost). The same key with another body: 422 `idempotency_key_reused`; while the first call still runs: 409.  `isTest: true` creates a test workspace linked to the current production workspace (`parentWorkspaceId`), optionally copying its charts (`copyCharts`). Written to the audit log of the current workspace (`workspace.create` / `workspace.create_test`) and, for a production workspace, of the new one. Returns a new `publicKey`: not a secret and not a Bearer substitute.
     # @param post_api_workspaces_request [PostApiWorkspacesRequest] 
     # @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.
@@ -1938,7 +1948,7 @@ module SeatsChart
     end
 
     # Create a workspace (provision an organizer)
-    # Provisions a workspace and admin membership for the caller: a dashboard admin session, or a **full-access workspace admin API key** (&#x60;POST /api/keys&#x60; with &#x60;workspaceAdmin: true&#x60;), whose bound admin becomes the admin of the new workspace. Other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;.  **Ticketing platforms (one workspace per organizer):** send &#x60;externalId&#x60; (your organizer id), &#x60;templateWorkspaceId&#x60; (a workspace whose integration settings, embed domains and webhooks to copy) and &#x60;issueKey&#x60; (mint the organizer&#39;s API key in the same call). A workspace created by a workspace admin key is marked &#x60;createdByApi&#x60;, starts on the platform account plan (&#x60;default_plan_id&#x60; of the admin, e.g. Ultra On-Demand) and is billed to the platform: its members never see checkout or upgrade prompts. Without a template it starts with partner pricing and the platform defaults. Then call any partner route in it with the same admin key and &#x60;X-Workspace-Key: &lt;workspaceId or externalId&gt;&#x60;.  **Idempotency:** send &#x60;Idempotency-Key&#x60; (1–255 characters): the same key and body within 24 hours returns the first result with &#x60;idempotentReplay: true&#x60; and every secret &#x60;null&#x60; (secrets are never stored; rotate the key if the first response was lost). The same key with another body: 422 &#x60;idempotency_key_reused&#x60;; while the first call still runs: 409.  &#x60;isTest: true&#x60; creates a test workspace linked to the current production workspace (&#x60;parentWorkspaceId&#x60;), optionally copying its charts (&#x60;copyCharts&#x60;). Written to the audit log of the current workspace (&#x60;workspace.create&#x60; / &#x60;workspace.create_test&#x60;) and, for a production workspace, of the new one. Returns a new &#x60;publicKey&#x60;: not a secret and not a Bearer substitute.
+    # Provisions a workspace and admin membership for the caller: a dashboard admin session, or a **full-access workspace admin API key** (&#x60;POST /api/keys&#x60; with &#x60;workspaceAdmin: true&#x60;), whose bound admin becomes the admin of the new workspace. Other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;.  **Ticketing platforms (one workspace per organizer):** send &#x60;externalId&#x60; (your organizer id), &#x60;templateWorkspaceId&#x60; (a workspace whose integration settings, embed domains and webhooks to copy) and &#x60;issueKey&#x60; (mint the organizer&#39;s API key in the same call). A workspace created by a workspace admin key is marked &#x60;createdByApi&#x60;, joins the platform admin&#39;s billing account (one plan for every workspace of the account, e.g. Ultra On-Demand: its charts, events and seats count with the others) and is billed to the platform: its members never see checkout or upgrade prompts. A workspace created in the dashboard joins the creator&#39;s billing account the same way, and a sandbox its parent&#39;s. Without a template it starts with partner pricing and the platform defaults. Then call any partner route in it with the same admin key and &#x60;X-Workspace-Key: &lt;workspaceId or externalId&gt;&#x60;.  **Idempotency:** send &#x60;Idempotency-Key&#x60; (1–255 characters): the same key and body within 24 hours returns the first result with &#x60;idempotentReplay: true&#x60; and every secret &#x60;null&#x60; (secrets are never stored; rotate the key if the first response was lost). The same key with another body: 422 &#x60;idempotency_key_reused&#x60;; while the first call still runs: 409.  &#x60;isTest: true&#x60; creates a test workspace linked to the current production workspace (&#x60;parentWorkspaceId&#x60;), optionally copying its charts (&#x60;copyCharts&#x60;). Written to the audit log of the current workspace (&#x60;workspace.create&#x60; / &#x60;workspace.create_test&#x60;) and, for a production workspace, of the new one. Returns a new &#x60;publicKey&#x60;: not a secret and not a Bearer substitute.
     # @param post_api_workspaces_request [PostApiWorkspacesRequest] 
     # @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.
@@ -2170,7 +2180,7 @@ module SeatsChart
     end
 
     # Delete a workspace
-    # Soft delete: the workspace and every chart, event, order and audit entry stay in the database, but it leaves every list and switcher (including GET /workspaces), its members lose access, and its API keys, embed and viewer tokens and public reads are refused like a deactivated workspace (403 `workspace_deactivated`, at once on every API instance); `X-Workspace-Key` calls to it answer 404. Its sandboxes are deleted with it. It cannot be reactivated from the product (restoring is a support request). Dashboard session, or a **workspace admin API key** (offboarding an organizer; it cannot delete its own workspace: 409 `own_workspace`); other API keys: 403 `ERR_PARTNER_SCOPE`. The caller must be an **admin** of the workspace (403 `ERR_FORBIDDEN_ROLE`; 404 when not a member or already deleted). Send `confirmName` (the workspace name) or `confirmWorkspaceId` (its id); a mismatch answers 400 `confirmation_mismatch`. Refused while a paid subscription is active (409 `subscription_active`: cancel it in Billing first), for your only remaining workspace (409 `last_workspace`) and for a sandbox (409 `sandbox_workspace`). When it is the workspace of the calling session, `switchTo` names the workspace to switch to. Written to the audit log (`workspace.delete`) of the deleted workspace and of the one the session switches to.
+    # Soft delete: the workspace and every chart, event, order and audit entry stay in the database, but it leaves every list and switcher (including GET /workspaces), its members lose access, and its API keys, embed and viewer tokens and public reads are refused like a deactivated workspace (403 `workspace_deactivated`, at once on every API instance); `X-Workspace-Key` calls to it answer 404. Its sandboxes are deleted with it. It cannot be reactivated from the product (restoring is a support request). Dashboard session, or a **workspace admin API key** (offboarding an organizer; it cannot delete its own workspace: 409 `own_workspace`); other API keys: 403 `ERR_PARTNER_SCOPE`. The caller must be an **admin** of the workspace (403 `ERR_FORBIDDEN_ROLE`; 404 when not a member or already deleted). Send `confirmName` (the workspace name) or `confirmWorkspaceId` (its id); a mismatch answers 400 `confirmation_mismatch`. Refused for the last workspace of a billing account whose paid subscription is active (409 `subscription_active`: cancel it in Billing first), for your only remaining workspace (409 `last_workspace`) and for a sandbox (409 `sandbox_workspace`). When it is the workspace of the calling session, `switchTo` names the workspace to switch to. Written to the audit log (`workspace.delete`) of the deleted workspace and of the one the session switches to.
     # @param workspace_id [String] 
     # @param post_api_workspaces_by_workspace_id_actions_delete_request [PostApiWorkspacesByWorkspaceIdActionsDeleteRequest] 
     # @param [Hash] opts the optional parameters
@@ -2182,7 +2192,7 @@ module SeatsChart
     end
 
     # Delete a workspace
-    # Soft delete: the workspace and every chart, event, order and audit entry stay in the database, but it leaves every list and switcher (including GET /workspaces), its members lose access, and its API keys, embed and viewer tokens and public reads are refused like a deactivated workspace (403 &#x60;workspace_deactivated&#x60;, at once on every API instance); &#x60;X-Workspace-Key&#x60; calls to it answer 404. Its sandboxes are deleted with it. It cannot be reactivated from the product (restoring is a support request). Dashboard session, or a **workspace admin API key** (offboarding an organizer; it cannot delete its own workspace: 409 &#x60;own_workspace&#x60;); other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;. The caller must be an **admin** of the workspace (403 &#x60;ERR_FORBIDDEN_ROLE&#x60;; 404 when not a member or already deleted). Send &#x60;confirmName&#x60; (the workspace name) or &#x60;confirmWorkspaceId&#x60; (its id); a mismatch answers 400 &#x60;confirmation_mismatch&#x60;. Refused while a paid subscription is active (409 &#x60;subscription_active&#x60;: cancel it in Billing first), for your only remaining workspace (409 &#x60;last_workspace&#x60;) and for a sandbox (409 &#x60;sandbox_workspace&#x60;). When it is the workspace of the calling session, &#x60;switchTo&#x60; names the workspace to switch to. Written to the audit log (&#x60;workspace.delete&#x60;) of the deleted workspace and of the one the session switches to.
+    # Soft delete: the workspace and every chart, event, order and audit entry stay in the database, but it leaves every list and switcher (including GET /workspaces), its members lose access, and its API keys, embed and viewer tokens and public reads are refused like a deactivated workspace (403 &#x60;workspace_deactivated&#x60;, at once on every API instance); &#x60;X-Workspace-Key&#x60; calls to it answer 404. Its sandboxes are deleted with it. It cannot be reactivated from the product (restoring is a support request). Dashboard session, or a **workspace admin API key** (offboarding an organizer; it cannot delete its own workspace: 409 &#x60;own_workspace&#x60;); other API keys: 403 &#x60;ERR_PARTNER_SCOPE&#x60;. The caller must be an **admin** of the workspace (403 &#x60;ERR_FORBIDDEN_ROLE&#x60;; 404 when not a member or already deleted). Send &#x60;confirmName&#x60; (the workspace name) or &#x60;confirmWorkspaceId&#x60; (its id); a mismatch answers 400 &#x60;confirmation_mismatch&#x60;. Refused for the last workspace of a billing account whose paid subscription is active (409 &#x60;subscription_active&#x60;: cancel it in Billing first), for your only remaining workspace (409 &#x60;last_workspace&#x60;) and for a sandbox (409 &#x60;sandbox_workspace&#x60;). When it is the workspace of the calling session, &#x60;switchTo&#x60; names the workspace to switch to. Written to the audit log (&#x60;workspace.delete&#x60;) of the deleted workspace and of the one the session switches to.
     # @param workspace_id [String] 
     # @param post_api_workspaces_by_workspace_id_actions_delete_request [PostApiWorkspacesByWorkspaceIdActionsDeleteRequest] 
     # @param [Hash] opts the optional parameters
@@ -2350,10 +2360,10 @@ module SeatsChart
     # @param post_api_workspaces_by_workspace_id_invitations_request [PostApiWorkspacesByWorkspaceIdInvitationsRequest] 
     # @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]
+    # @return [PostApiWorkspacesByWorkspaceIdInvitations201Response]
     def post_api_workspaces_by_workspace_id_invitations(workspace_id, post_api_workspaces_by_workspace_id_invitations_request, opts = {})
-      post_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, post_api_workspaces_by_workspace_id_invitations_request, opts)
-      nil
+      data, _status_code, _headers = post_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, post_api_workspaces_by_workspace_id_invitations_request, opts)
+      data
     end
 
     # Invite a person to a workspace you administer
@@ -2362,7 +2372,7 @@ module SeatsChart
     # @param post_api_workspaces_by_workspace_id_invitations_request [PostApiWorkspacesByWorkspaceIdInvitationsRequest] 
     # @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
+    # @return [Array<(PostApiWorkspacesByWorkspaceIdInvitations201Response, Integer, Hash)>] PostApiWorkspacesByWorkspaceIdInvitations201Response data, response status code and response headers
     def post_api_workspaces_by_workspace_id_invitations_with_http_info(workspace_id, post_api_workspaces_by_workspace_id_invitations_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: WorkspaceApi.post_api_workspaces_by_workspace_id_invitations ...'
@@ -2399,6 +2409,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
       if !content_type.nil?
@@ -2413,7 +2425,7 @@ module SeatsChart
       post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_workspaces_by_workspace_id_invitations_request)
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'PostApiWorkspacesByWorkspaceIdInvitations201Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']