seatschart 0.1.0

data/lib/seatschart/api/webhooks_api.rb

@@ -0,0 +1,771 @@
+=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 WebhooksApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Delete a webhook
+    # Removes the registration permanently. Idempotent `404` applies when the webhook id is unknown or belongs to another tenant.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @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 delete_api_webhooks_by_id(id, opts = {})
+      delete_api_webhooks_by_id_with_http_info(id, opts)
+      nil
+    end
+
+    # Delete a webhook
+    # Removes the registration permanently. Idempotent `404` applies when the webhook id is unknown or belongs to another tenant.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @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 delete_api_webhooks_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.delete_api_webhooks_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.delete_api_webhooks_by_id"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling WebhooksApi.delete_api_webhooks_by_id, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling WebhooksApi.delete_api_webhooks_by_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.delete_api_webhooks_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WebhooksApi#delete_api_webhooks_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List webhooks for the authenticated tenant
+    # Returns all outbound webhook endpoints of the authenticated tenant with their event-type subscription (`eventTypes`, `[\"*\"]` = all) and the outcome of the most recent delivery (`lastDelivery`). Requires the `webhooks` scope for scoped API keys.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_webhooks(opts = {})
+      get_api_webhooks_with_http_info(opts)
+      nil
+    end
+
+    # List webhooks for the authenticated tenant
+    # Returns all outbound webhook endpoints of the authenticated tenant with their event-type subscription (&#x60;eventTypes&#x60;, &#x60;[\&quot;*\&quot;]&#x60; &#x3D; all) and the outcome of the most recent delivery (&#x60;lastDelivery&#x60;). Requires the &#x60;webhooks&#x60; scope for scoped API keys.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_webhooks_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.get_api_webhooks ...'
+      end
+      # resource path
+      local_var_path = '/api/webhooks'
+
+      # 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 => :"WebhooksApi.get_api_webhooks",
+        :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: WebhooksApi#get_api_webhooks\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List deliveries of a webhook endpoint
+    # Newest first, cursor-paginated (`nextCursor`). Combines the durable SQL outbox (`reservations.confirmed`, retried with exponential backoff) with fire-and-forget dispatches (`holds.*`, `ga.*`, `objects.updated`, …), test events and replays. Entries expose event id, type, status, attempts, HTTP status and a stable error code only — never response bodies, URLs or credentials. Direct-send entries are retained for `WEBHOOK_DELIVERY_RETENTION_DAYS` (default 30).
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @option opts [String] :status &#x60;pending&#x60; also matches deliveries currently being attempted (&#x60;processing&#x60;).
+    # @option opts [String] :event_type 
+    # @option opts [String] :source 
+    # @return [nil]
+    def get_api_webhooks_by_id_deliveries(id, opts = {})
+      get_api_webhooks_by_id_deliveries_with_http_info(id, opts)
+      nil
+    end
+
+    # List deliveries of a webhook endpoint
+    # Newest first, cursor-paginated (&#x60;nextCursor&#x60;). Combines the durable SQL outbox (&#x60;reservations.confirmed&#x60;, retried with exponential backoff) with fire-and-forget dispatches (&#x60;holds.*&#x60;, &#x60;ga.*&#x60;, &#x60;objects.updated&#x60;, …), test events and replays. Entries expose event id, type, status, attempts, HTTP status and a stable error code only — never response bodies, URLs or credentials. Direct-send entries are retained for &#x60;WEBHOOK_DELIVERY_RETENTION_DAYS&#x60; (default 30).
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit Page size (1..100, default 20).
+    # @option opts [String] :cursor Opaque &#x60;nextCursor&#x60; value from the previous page.
+    # @option opts [String] :status &#x60;pending&#x60; also matches deliveries currently being attempted (&#x60;processing&#x60;).
+    # @option opts [String] :event_type 
+    # @option opts [String] :source 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_webhooks_by_id_deliveries_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.get_api_webhooks_by_id_deliveries ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.get_api_webhooks_by_id_deliveries"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length > 512
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, the character length must be smaller than or equal to 512.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"cursor"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9_-]+$/)
+      if @api_client.config.client_side_validation && !opts[:'cursor'].nil? && opts[:'cursor'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"cursor\"]' when calling WebhooksApi.get_api_webhooks_by_id_deliveries, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["delivered", "failed", "pending"]
+      if @api_client.config.client_side_validation && opts[:'status'] && !allowable_values.include?(opts[:'status'])
+        fail ArgumentError, "invalid value for \"status\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'event_type'].nil? && opts[:'event_type'].to_s.length > 64
+        fail ArgumentError, 'invalid value for "opts[:"event_type"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'event_type'].nil? && opts[:'event_type'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"event_type"]" when calling WebhooksApi.get_api_webhooks_by_id_deliveries, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[a-z.]+$/)
+      if @api_client.config.client_side_validation && !opts[:'event_type'].nil? && opts[:'event_type'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"event_type\"]' when calling WebhooksApi.get_api_webhooks_by_id_deliveries, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = ["outbox", "dispatch", "test", "replay"]
+      if @api_client.config.client_side_validation && opts[:'source'] && !allowable_values.include?(opts[:'source'])
+        fail ArgumentError, "invalid value for \"source\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/webhooks/{id}/deliveries'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'eventType'] = opts[:'event_type'] if !opts[:'event_type'].nil?
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+
+      # 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 => :"WebhooksApi.get_api_webhooks_by_id_deliveries",
+        :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: WebhooksApi#get_api_webhooks_by_id_deliveries\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get one webhook delivery with its request payload
+    # Same fields as the list plus `payload`: the JSON request body that was sent (identical bytes are re-sent by replay). Remote response bodies are never stored.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param delivery_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_webhooks_by_id_deliveries_by_delivery_id(id, delivery_id, opts = {})
+      get_api_webhooks_by_id_deliveries_by_delivery_id_with_http_info(id, delivery_id, opts)
+      nil
+    end
+
+    # Get one webhook delivery with its request payload
+    # Same fields as the list plus &#x60;payload&#x60;: the JSON request body that was sent (identical bytes are re-sent by replay). Remote response bodies are never stored.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param delivery_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_webhooks_by_id_deliveries_by_delivery_id_with_http_info(id, delivery_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.get_api_webhooks_by_id_deliveries_by_delivery_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.get_api_webhooks_by_id_deliveries_by_delivery_id"
+      end
+      # verify the required parameter 'delivery_id' is set
+      if @api_client.config.client_side_validation && delivery_id.nil?
+        fail ArgumentError, "Missing the required parameter 'delivery_id' when calling WebhooksApi.get_api_webhooks_by_id_deliveries_by_delivery_id"
+      end
+      # resource path
+      local_var_path = '/api/webhooks/{id}/deliveries/{deliveryId}'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'deliveryId' + '}', CGI.escape(delivery_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 => :"WebhooksApi.get_api_webhooks_by_id_deliveries_by_delivery_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WebhooksApi#get_api_webhooks_by_id_deliveries_by_delivery_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List subscribable webhook event types
+    # Event types an endpoint can subscribe to through `eventTypes`. `webhook.test` is sent only by `POST /api/webhooks/{id}/test` and cannot be subscribed to.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_webhooks_event_types(opts = {})
+      get_api_webhooks_event_types_with_http_info(opts)
+      nil
+    end
+
+    # List subscribable webhook event types
+    # Event types an endpoint can subscribe to through &#x60;eventTypes&#x60;. &#x60;webhook.test&#x60; is sent only by &#x60;POST /api/webhooks/{id}/test&#x60; and cannot be subscribed to.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_webhooks_event_types_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.get_api_webhooks_event_types ...'
+      end
+      # resource path
+      local_var_path = '/api/webhooks/event-types'
+
+      # 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 => :"WebhooksApi.get_api_webhooks_event_types",
+        :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: WebhooksApi#get_api_webhooks_event_types\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update a webhook
+    # Partial update of `url`, `isActive` and/or `eventTypes` (`[\"*\"]` = every type). Subscription changes apply to events emitted afterwards; queued outbox retries keep their original destinations. Only webhooks owned by the authenticated tenant can be modified.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param patch_api_webhooks_by_id_request [PatchApiWebhooksByIdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [nil]
+    def patch_api_webhooks_by_id(id, patch_api_webhooks_by_id_request, opts = {})
+      patch_api_webhooks_by_id_with_http_info(id, patch_api_webhooks_by_id_request, opts)
+      nil
+    end
+
+    # Update a webhook
+    # Partial update of &#x60;url&#x60;, &#x60;isActive&#x60; and/or &#x60;eventTypes&#x60; (&#x60;[\&quot;*\&quot;]&#x60; &#x3D; every type). Subscription changes apply to events emitted afterwards; queued outbox retries keep their original destinations. Only webhooks owned by the authenticated tenant can be modified.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param patch_api_webhooks_by_id_request [PatchApiWebhooksByIdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def patch_api_webhooks_by_id_with_http_info(id, patch_api_webhooks_by_id_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.patch_api_webhooks_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.patch_api_webhooks_by_id"
+      end
+      # verify the required parameter 'patch_api_webhooks_by_id_request' is set
+      if @api_client.config.client_side_validation && patch_api_webhooks_by_id_request.nil?
+        fail ArgumentError, "Missing the required parameter 'patch_api_webhooks_by_id_request' when calling WebhooksApi.patch_api_webhooks_by_id"
+      end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling WebhooksApi.patch_api_webhooks_by_id, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling WebhooksApi.patch_api_webhooks_by_id, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(patch_api_webhooks_by_id_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.patch_api_webhooks_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WebhooksApi#patch_api_webhooks_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a webhook endpoint
+    # Registers an HTTPS callback URL (except `http://localhost` / `127.0.0.1` only for local development). Duplicate URLs per tenant are rejected with `409 Conflict`. `eventTypes` defaults to `[\"*\"]` (every type); unknown types are rejected with `400`. The response includes `signingSecret` exactly once: deliveries to this endpoint carry `x-seatschart-signature: sha256=<hex HMAC-SHA256 of the raw body>` keyed with it, plus `x-seatschart-timestamp` and `x-seatschart-signature-v2: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"t.rawBody\">` (recommended: verify v1 in constant time and reject timestamps more than 5 minutes old), `X-SeatsChart-Event` and `X-SeatsChart-Event-Id`. In production the host is DNS-resolved at registration and refused when any record is loopback, private, link-local, CGNAT or metadata; every send re-resolves and pins a public address and never follows redirects.
+    # @param post_api_webhooks_request [PostApiWebhooksRequest] 
+    # @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_webhooks(post_api_webhooks_request, opts = {})
+      post_api_webhooks_with_http_info(post_api_webhooks_request, opts)
+      nil
+    end
+
+    # Create a webhook endpoint
+    # Registers an HTTPS callback URL (except &#x60;http://localhost&#x60; / &#x60;127.0.0.1&#x60; only for local development). Duplicate URLs per tenant are rejected with &#x60;409 Conflict&#x60;. &#x60;eventTypes&#x60; defaults to &#x60;[\&quot;*\&quot;]&#x60; (every type); unknown types are rejected with &#x60;400&#x60;. The response includes &#x60;signingSecret&#x60; exactly once: deliveries to this endpoint carry &#x60;x-seatschart-signature: sha256&#x3D;&lt;hex HMAC-SHA256 of the raw body&gt;&#x60; keyed with it, plus &#x60;x-seatschart-timestamp&#x60; and &#x60;x-seatschart-signature-v2: t&#x3D;&lt;unix seconds&gt;,v1&#x3D;&lt;hex HMAC-SHA256 of \&quot;t.rawBody\&quot;&gt;&#x60; (recommended: verify v1 in constant time and reject timestamps more than 5 minutes old), &#x60;X-SeatsChart-Event&#x60; and &#x60;X-SeatsChart-Event-Id&#x60;. In production the host is DNS-resolved at registration and refused when any record is loopback, private, link-local, CGNAT or metadata; every send re-resolves and pins a public address and never follows redirects.
+    # @param post_api_webhooks_request [PostApiWebhooksRequest] 
+    # @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_webhooks_with_http_info(post_api_webhooks_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.post_api_webhooks ...'
+      end
+      # verify the required parameter 'post_api_webhooks_request' is set
+      if @api_client.config.client_side_validation && post_api_webhooks_request.nil?
+        fail ArgumentError, "Missing the required parameter 'post_api_webhooks_request' when calling WebhooksApi.post_api_webhooks"
+      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 WebhooksApi.post_api_webhooks, 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 WebhooksApi.post_api_webhooks, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks'
+
+      # 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_webhooks_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.post_api_webhooks",
+        :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: WebhooksApi#post_api_webhooks\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replay a webhook delivery
+    # Re-sends the identical request body and `X-SeatsChart-Event-Id` of the original delivery, signed with the endpoint’s CURRENT secret (`x-seatschart-signature`), so receivers can deduplicate by event id. One synchronous attempt; the result is recorded as a new `replay` delivery and returned with `200` whether the remote accepted it or not (inspect `delivery.status`). Works for paused endpoints. Rate limited per workspace (`WEBHOOK_MANUAL_SEND_MAX` per `WEBHOOK_MANUAL_SEND_WINDOW_SEC`, default 30/60 s): `429` with `Retry-After`.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param delivery_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. Repeating a replay with the same key returns the first result instead of sending again.
+    # @return [nil]
+    def post_api_webhooks_by_id_deliveries_by_delivery_id_replay(id, delivery_id, opts = {})
+      post_api_webhooks_by_id_deliveries_by_delivery_id_replay_with_http_info(id, delivery_id, opts)
+      nil
+    end
+
+    # Replay a webhook delivery
+    # Re-sends the identical request body and &#x60;X-SeatsChart-Event-Id&#x60; of the original delivery, signed with the endpoint’s CURRENT secret (&#x60;x-seatschart-signature&#x60;), so receivers can deduplicate by event id. One synchronous attempt; the result is recorded as a new &#x60;replay&#x60; delivery and returned with &#x60;200&#x60; whether the remote accepted it or not (inspect &#x60;delivery.status&#x60;). Works for paused endpoints. Rate limited per workspace (&#x60;WEBHOOK_MANUAL_SEND_MAX&#x60; per &#x60;WEBHOOK_MANUAL_SEND_WINDOW_SEC&#x60;, default 30/60 s): &#x60;429&#x60; with &#x60;Retry-After&#x60;.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param delivery_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Optional. Repeating a replay with the same key returns the first result instead of sending again.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_webhooks_by_id_deliveries_by_delivery_id_replay_with_http_info(id, delivery_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay"
+      end
+      # verify the required parameter 'delivery_id' is set
+      if @api_client.config.client_side_validation && delivery_id.nil?
+        fail ArgumentError, "Missing the required parameter 'delivery_id' when calling WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay"
+      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 WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay, 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 WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks/{id}/deliveries/{deliveryId}/replay'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'deliveryId' + '}', CGI.escape(delivery_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.post_api_webhooks_by_id_deliveries_by_delivery_id_replay",
+        :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: WebhooksApi#post_api_webhooks_by_id_deliveries_by_delivery_id_replay\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Rotate a webhook signing secret
+    # Replaces the endpoint HMAC key and returns the new `signingSecret` once. The old key stops working immediately, including for queued retries. Endpoints created before per-endpoint secrets are signed with the deployment `WEBHOOK_SIGNING_SECRET` until rotated.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @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_webhooks_by_id_rotate_secret(id, opts = {})
+      post_api_webhooks_by_id_rotate_secret_with_http_info(id, opts)
+      nil
+    end
+
+    # Rotate a webhook signing secret
+    # Replaces the endpoint HMAC key and returns the new &#x60;signingSecret&#x60; once. The old key stops working immediately, including for queued retries. Endpoints created before per-endpoint secrets are signed with the deployment &#x60;WEBHOOK_SIGNING_SECRET&#x60; until rotated.
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @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_webhooks_by_id_rotate_secret_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.post_api_webhooks_by_id_rotate_secret ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.post_api_webhooks_by_id_rotate_secret"
+      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 WebhooksApi.post_api_webhooks_by_id_rotate_secret, 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 WebhooksApi.post_api_webhooks_by_id_rotate_secret, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks/{id}/rotate-secret'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.post_api_webhooks_by_id_rotate_secret",
+        :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: WebhooksApi#post_api_webhooks_by_id_rotate_secret\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Send a signed test event
+    # Sends `{\"eventId\",\"type\":\"webhook.test\",\"occurred_at\",\"tenant_id\",\"test\":true,\"items\":[]}` signed with the endpoint’s current secret, regardless of its event-type subscription or paused state. One synchronous attempt recorded as a `test` delivery; `200` with `delivery.status` `delivered` or `failed` (`httpStatus`, `lastErrorCode`). Shares the replay rate limit (`429` + `Retry-After`).
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key 
+    # @return [nil]
+    def post_api_webhooks_by_id_test(id, opts = {})
+      post_api_webhooks_by_id_test_with_http_info(id, opts)
+      nil
+    end
+
+    # Send a signed test event
+    # Sends &#x60;{\&quot;eventId\&quot;,\&quot;type\&quot;:\&quot;webhook.test\&quot;,\&quot;occurred_at\&quot;,\&quot;tenant_id\&quot;,\&quot;test\&quot;:true,\&quot;items\&quot;:[]}&#x60; signed with the endpoint’s current secret, regardless of its event-type subscription or paused state. One synchronous attempt recorded as a &#x60;test&#x60; delivery; &#x60;200&#x60; with &#x60;delivery.status&#x60; &#x60;delivered&#x60; or &#x60;failed&#x60; (&#x60;httpStatus&#x60;, &#x60;lastErrorCode&#x60;). Shares the replay rate limit (&#x60;429&#x60; + &#x60;Retry-After&#x60;).
+    # @param id [String] Webhook UUID (stored lowercase)
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_api_webhooks_by_id_test_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.post_api_webhooks_by_id_test ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling WebhooksApi.post_api_webhooks_by_id_test"
+      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 WebhooksApi.post_api_webhooks_by_id_test, 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 WebhooksApi.post_api_webhooks_by_id_test, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/webhooks/{id}/test'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      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]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.post_api_webhooks_by_id_test",
+        :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: WebhooksApi#post_api_webhooks_by_id_test\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end