repull 0.2.22 → 0.2.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d82e6cd661dd24e5c301a3162fff5560c896fa50d1696e44654d6db67db81317
-  data.tar.gz: 1d972a3761ad092c24275b67aa19631e960a4a751096b014d738bbb426878ede
+  metadata.gz: be99faa1ce8ed6c0f212d4e08868a97f1a17d60bfb706cf5a8d3e38edfba78ff
+  data.tar.gz: 97fde1b3eb6f93014f233b7bf3fb7fbc5b4ad9b3d5273833e8245175f2444d4a
 SHA512:
-  metadata.gz: 234137120348095122ef508b8e5f3d7131d9710a78eed691605725ebd8fb1e63126aa343cc1f403bd3c23fdc021f0309e2d3bba564e4d1f935120881057f38b4
-  data.tar.gz: c8d682f2905897c8ab0b91a18e637dd1e5c953217f924d0c5fe1822d68267c91b97162338191dc7f86bad343752e6b676c5afd4bf8c84486c5b7fcef16df6e46
+  metadata.gz: f72d50e4e84bcf98d4e7800bd603aeb6b8bc7606ad6f1b4edd37296d58c6504e2303b03f1d2c2faefccde29576ddb4e7fce0a1d6fef4bab772fb32bb7fb7adf2
+  data.tar.gz: 6075f9b6a4e73b0b088319fc366b06251730944d36390fda2e3bfd8003696a6e6037375b93b163b1036dd2c625ac7e7f12f11891bfc0bb5c8110f74d74797911

data/lib/repull/api/airbnb_api.rb

@@ -744,24 +744,24 @@ module Repull
       return data, status_code, headers
     end
 
-    # Edit Airbnb host review
-    # Edit a host-side review for an Airbnb stay. Airbnb collapses POST + PUT into the same upstream call (`PUT /v2/listing_reviews/{id}`), so this endpoint covers both initial submit and subsequent edits while the review window is open.  Body is a partial `AirbnbReview` — pass the fields you want to change (rating, public review, private feedback, category ratings).  Returns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.
-    # @param id [String] Airbnb review id (`HRabc123` style).
-    # @param airbnb_review [AirbnbReview] 
+    # Submit your review of a guest (publishes, final)
+    # Submit your review of a guest — the review with `reviewerRole: \"host\"`. **Submitting publishes it and is final:** Airbnb has no draft and does not allow edits; a second submission is `409 review_already_submitted`. Airbnb accepts it up to 14 days after checkout (`expiresAt`).  Required: `publicReview`, `isRevieweeRecommended` (whether you would host the guest again), and a 1–5 rating for **each** of `cleanliness`, `communication` and `respect_house_rules` — send `rating` to use one score for all three, `categoryRatings` to score them individually, or both (`rating` fills any category you did not rate). Optional: `privateFeedback`, a note to the guest that is not published. A request missing a required piece is refused with `422 invalid_params` naming it, before anything is sent to Airbnb.  ```json {   \"publicReview\": \"Joanne was a great guest.\",   \"rating\": 5,   \"privateFeedback\": \"Thanks for leaving the place so tidy!\",   \"isRevieweeRecommended\": true } ```  A guest's review of you (`reviewerRole: \"guest\"`) cannot be written here — `409 not_host_review`; reply to it with `POST /v1/channels/airbnb/reviews/{id}/respond`. After the window closes: `409 review_window_closed`. Full guide: https://repull.dev/docs/channels/airbnb/reviews
+    # @param id [String] The review's `id` or `externalReviewId`, both as returned by `GET /v1/reviews`.
+    # @param airbnb_host_review_submit [AirbnbHostReviewSubmit] 
     # @param [Hash] opts the optional parameters
     # @return [AirbnbReview]
-    def edit_airbnb_review(id, airbnb_review, opts = {})
-      data, _status_code, _headers = edit_airbnb_review_with_http_info(id, airbnb_review, opts)
+    def edit_airbnb_review(id, airbnb_host_review_submit, opts = {})
+      data, _status_code, _headers = edit_airbnb_review_with_http_info(id, airbnb_host_review_submit, opts)
       data
     end
 
-    # Edit Airbnb host review
-    # Edit a host-side review for an Airbnb stay. Airbnb collapses POST + PUT into the same upstream call (`PUT /v2/listing_reviews/{id}`), so this endpoint covers both initial submit and subsequent edits while the review window is open.  Body is a partial `AirbnbReview` — pass the fields you want to change (rating, public review, private feedback, category ratings).  Returns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.
-    # @param id [String] Airbnb review id (`HRabc123` style).
-    # @param airbnb_review [AirbnbReview] 
+    # Submit your review of a guest (publishes, final)
+    # Submit your review of a guest — the review with `reviewerRole: \"host\"`. **Submitting publishes it and is final:** Airbnb has no draft and does not allow edits; a second submission is `409 review_already_submitted`. Airbnb accepts it up to 14 days after checkout (`expiresAt`).  Required: `publicReview`, `isRevieweeRecommended` (whether you would host the guest again), and a 1–5 rating for **each** of `cleanliness`, `communication` and `respect_house_rules` — send `rating` to use one score for all three, `categoryRatings` to score them individually, or both (`rating` fills any category you did not rate). Optional: `privateFeedback`, a note to the guest that is not published. A request missing a required piece is refused with `422 invalid_params` naming it, before anything is sent to Airbnb.  ```json {   \"publicReview\": \"Joanne was a great guest.\",   \"rating\": 5,   \"privateFeedback\": \"Thanks for leaving the place so tidy!\",   \"isRevieweeRecommended\": true } ```  A guest's review of you (`reviewerRole: \"guest\"`) cannot be written here — `409 not_host_review`; reply to it with `POST /v1/channels/airbnb/reviews/{id}/respond`. After the window closes: `409 review_window_closed`. Full guide: https://repull.dev/docs/channels/airbnb/reviews
+    # @param id [String] The review's `id` or `externalReviewId`, both as returned by `GET /v1/reviews`.
+    # @param airbnb_host_review_submit [AirbnbHostReviewSubmit] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(AirbnbReview, Integer, Hash)>] AirbnbReview data, response status code and response headers
-    def edit_airbnb_review_with_http_info(id, airbnb_review, opts = {})
+    def edit_airbnb_review_with_http_info(id, airbnb_host_review_submit, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AirbnbApi.edit_airbnb_review ...'
       end
@@ -769,9 +769,9 @@ module Repull
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling AirbnbApi.edit_airbnb_review"
       end
-      # verify the required parameter 'airbnb_review' is set
-      if @api_client.config.client_side_validation && airbnb_review.nil?
-        fail ArgumentError, "Missing the required parameter 'airbnb_review' when calling AirbnbApi.edit_airbnb_review"
+      # verify the required parameter 'airbnb_host_review_submit' is set
+      if @api_client.config.client_side_validation && airbnb_host_review_submit.nil?
+        fail ArgumentError, "Missing the required parameter 'airbnb_host_review_submit' when calling AirbnbApi.edit_airbnb_review"
       end
       # resource path
       local_var_path = '/v1/channels/airbnb/reviews/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -793,7 +793,7 @@ module Repull
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(airbnb_review)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(airbnb_host_review_submit)
 
       # return_type
       return_type = opts[:debug_return_type] || 'AirbnbReview'

data/lib/repull/models/airbnb_host_review_submit.rb

@@ -0,0 +1,281 @@
+=begin
+#Repull API
+
+#The unified API for vacation rental tech. Connect to 50+ PMS platforms and 4 OTA channels through one REST API. Built-in AI operations for guest communication, pricing, and listing optimization.  ## Designed for AI agents Every error response on this API includes machine-parseable fields so an LLM (Claude in MCP, Cursor, Cline, GPT, etc.) can self-recover without escalating to a human: - `error.code` — stable string identifier (e.g. `invalid_params`, `rate_limit_exceeded`) - `error.message` — human-readable cause - `error.fix` — exact recovery steps (e.g. \"Pass `check_in_after` as ISO 8601: `?check_in_after=2026-01-15`\") - `error.docs_url` — link to the canonical write-up at `https://repull.dev/docs/errors/{code}` - `error.request_id` — id to correlate with server-side logs - `error.field` / `error.value_received` / `error.valid_values` / `error.did_you_mean` — when the error is parameter-specific - `error.retry_after` — seconds to wait before retrying (rate-limit + transient upstream)  `Access-Control-Expose-Headers` lists `x-request-id` and the `X-RateLimit-*` family so browsers can read them on cross-origin responses.  ## Quick Start 1. Get an API key at https://repull.dev/dashboard 2. Connect a PMS: `POST /v1/connect/{provider}` 3. List properties: `GET /v1/properties` 4. Get reservations: `GET /v1/reservations`  ## Authentication All requests require a Bearer token: ``` Authorization: Bearer sk_live_YOUR_API_KEY ```  ## Request Correlation (X-Request-ID) Every response carries an `X-Request-ID` header, e.g. `X-Request-ID: req_01HXY...`. Include this id in support tickets and bug reports — we can trace the full request lifecycle (auth, rate limit, handler, downstream calls, log row) from a single id.  You may set the header on the inbound request to forward your own trace id; we will echo it back instead of generating a new one. Accepted format: `^[\\\\w.-]{1,128}$`.  The id is also embedded in error envelopes as `request_id` so server-side log diffs work even when the response headers are stripped by an intermediate proxy.  ## Rate Limits The public API enforces a per-API-key sliding-window rate limit on top of the per-tier monthly + daily-AI quotas.  **Default policy:** 600 requests per 60 seconds, per API key. Sliding window — there is no fixed-minute boundary you can burst across.  Every response includes:  | Header | Meaning | |---|---| | `X-RateLimit-Limit` | Requests permitted in the current window. | | `X-RateLimit-Remaining` | Requests left in the current window after this call. | | `X-RateLimit-Reset` | Unix epoch (seconds) when the next slot opens. | | `X-RateLimit-Policy` | Machine-readable policy descriptor, e.g. `600;w=60`. | | `Retry-After` | Seconds to wait before retrying. **Only present on 429 responses.** |  **On 429 (rate_limit_exceeded):** the response body matches the standard error envelope with `code: \"rate_limit_exceeded\"`, plus `limit`, `window_seconds`, `retry_after`, and `request_id` fields. SDKs MUST honor `Retry-After` and use exponential backoff with jitter on subsequent retries — never a tight loop.  Recommended backoff: ``` sleep_ms = (Retry-After * 1000) + random(0..250) ```  Monthly + daily-AI tier quotas (`free`, `starter`, `custom`) are enforced separately and also surface as 429s; they include `tier`, `scope`, and `resetsAt` fields.  ## Plan Limits (402 — `listings_limit_exceeded`) The Repull API also enforces a per-tier cap on **active listings**:  | Tier | Active listings cap | |---|---| | `free` | 3 | | `starter` | 50 | | `custom` | unlimited |  When a customer's active-listing count is above their tier cap, the API returns **`402 Payment Required`** with `error.code = \"listings_limit_exceeded\"` on every route EXCEPT:  - `/v1/health` — uptime probes are never gated. - `/v1/usage/*` — so dashboards can render the over-cap state. - Any `DELETE` — so the customer can trim listings to get back under the cap without paying.  Unlike 429, 402 is NOT a \"wait and retry\" condition — `Retry-After` is not set. The only paths back to 200 are:   1. `DELETE` enough listings to come back under the cap, or   2. Upgrade at `https://repull.dev/dashboard/billing`. The server-side usage cache is 60s, so the first 200 after an upgrade may take up to a minute.  The envelope mirrors `rate_limit_exceeded` for SDK ergonomics: `tier`, `limit`, `active_listings`, `upgrade_url`, plus the standard `code` / `message` / `fix` / `docs_url` / `request_id`.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Repull
+  # Your review of a guest. Airbnb requires `publicReview`, `isRevieweeRecommended`, and a rating for each of cleanliness, communication and respect_house_rules — through `rating`, `categoryRatings`, or both. Submitting publishes it and is final.
+  class AirbnbHostReviewSubmit < ApiModelBase
+    # Shown publicly on the guest's profile. `comment` is accepted as an alias.
+    attr_accessor :public_review
+
+    # Used for every category not rated in `categoryRatings`.
+    attr_accessor :rating
+
+    # Per-category scores. Categories not listed take `rating`; without `rating`, all three must be listed.
+    attr_accessor :category_ratings
+
+    # Optional. A note to the guest that is not published.
+    attr_accessor :private_feedback
+
+    # Required. Whether you would host this guest again.
+    attr_accessor :is_reviewee_recommended
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'public_review' => :'publicReview',
+        :'rating' => :'rating',
+        :'category_ratings' => :'categoryRatings',
+        :'private_feedback' => :'privateFeedback',
+        :'is_reviewee_recommended' => :'isRevieweeRecommended'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'public_review' => :'String',
+        :'rating' => :'Integer',
+        :'category_ratings' => :'Array<AirbnbHostReviewSubmitCategoryRatingsInner>',
+        :'private_feedback' => :'String',
+        :'is_reviewee_recommended' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::AirbnbHostReviewSubmit` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::AirbnbHostReviewSubmit`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'public_review')
+        self.public_review = attributes[:'public_review']
+      else
+        self.public_review = nil
+      end
+
+      if attributes.key?(:'rating')
+        self.rating = attributes[:'rating']
+      end
+
+      if attributes.key?(:'category_ratings')
+        if (value = attributes[:'category_ratings']).is_a?(Array)
+          self.category_ratings = value
+        end
+      end
+
+      if attributes.key?(:'private_feedback')
+        self.private_feedback = attributes[:'private_feedback']
+      end
+
+      if attributes.key?(:'is_reviewee_recommended')
+        self.is_reviewee_recommended = attributes[:'is_reviewee_recommended']
+      else
+        self.is_reviewee_recommended = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @public_review.nil?
+        invalid_properties.push('invalid value for "public_review", public_review cannot be nil.')
+      end
+
+      if @public_review.to_s.length > 1000
+        invalid_properties.push('invalid value for "public_review", the character length must be smaller than or equal to 1000.')
+      end
+
+      if !@rating.nil? && @rating > 5
+        invalid_properties.push('invalid value for "rating", must be smaller than or equal to 5.')
+      end
+
+      if !@rating.nil? && @rating < 1
+        invalid_properties.push('invalid value for "rating", must be greater than or equal to 1.')
+      end
+
+      if !@private_feedback.nil? && @private_feedback.to_s.length > 1000
+        invalid_properties.push('invalid value for "private_feedback", the character length must be smaller than or equal to 1000.')
+      end
+
+      if @is_reviewee_recommended.nil?
+        invalid_properties.push('invalid value for "is_reviewee_recommended", is_reviewee_recommended cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @public_review.nil?
+      return false if @public_review.to_s.length > 1000
+      return false if !@rating.nil? && @rating > 5
+      return false if !@rating.nil? && @rating < 1
+      return false if !@private_feedback.nil? && @private_feedback.to_s.length > 1000
+      return false if @is_reviewee_recommended.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] public_review Value to be assigned
+    def public_review=(public_review)
+      if public_review.nil?
+        fail ArgumentError, 'public_review cannot be nil'
+      end
+
+      if public_review.to_s.length > 1000
+        fail ArgumentError, 'invalid value for "public_review", the character length must be smaller than or equal to 1000.'
+      end
+
+      @public_review = public_review
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] rating Value to be assigned
+    def rating=(rating)
+      if rating.nil?
+        fail ArgumentError, 'rating cannot be nil'
+      end
+
+      if rating > 5
+        fail ArgumentError, 'invalid value for "rating", must be smaller than or equal to 5.'
+      end
+
+      if rating < 1
+        fail ArgumentError, 'invalid value for "rating", must be greater than or equal to 1.'
+      end
+
+      @rating = rating
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] private_feedback Value to be assigned
+    def private_feedback=(private_feedback)
+      if private_feedback.nil?
+        fail ArgumentError, 'private_feedback cannot be nil'
+      end
+
+      if private_feedback.to_s.length > 1000
+        fail ArgumentError, 'invalid value for "private_feedback", the character length must be smaller than or equal to 1000.'
+      end
+
+      @private_feedback = private_feedback
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] is_reviewee_recommended Value to be assigned
+    def is_reviewee_recommended=(is_reviewee_recommended)
+      if is_reviewee_recommended.nil?
+        fail ArgumentError, 'is_reviewee_recommended cannot be nil'
+      end
+
+      @is_reviewee_recommended = is_reviewee_recommended
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          public_review == o.public_review &&
+          rating == o.rating &&
+          category_ratings == o.category_ratings &&
+          private_feedback == o.private_feedback &&
+          is_reviewee_recommended == o.is_reviewee_recommended
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [public_review, rating, category_ratings, private_feedback, is_reviewee_recommended].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/repull/models/airbnb_host_review_submit_category_ratings_inner.rb

@@ -0,0 +1,261 @@
+=begin
+#Repull API
+
+#The unified API for vacation rental tech. Connect to 50+ PMS platforms and 4 OTA channels through one REST API. Built-in AI operations for guest communication, pricing, and listing optimization.  ## Designed for AI agents Every error response on this API includes machine-parseable fields so an LLM (Claude in MCP, Cursor, Cline, GPT, etc.) can self-recover without escalating to a human: - `error.code` — stable string identifier (e.g. `invalid_params`, `rate_limit_exceeded`) - `error.message` — human-readable cause - `error.fix` — exact recovery steps (e.g. \"Pass `check_in_after` as ISO 8601: `?check_in_after=2026-01-15`\") - `error.docs_url` — link to the canonical write-up at `https://repull.dev/docs/errors/{code}` - `error.request_id` — id to correlate with server-side logs - `error.field` / `error.value_received` / `error.valid_values` / `error.did_you_mean` — when the error is parameter-specific - `error.retry_after` — seconds to wait before retrying (rate-limit + transient upstream)  `Access-Control-Expose-Headers` lists `x-request-id` and the `X-RateLimit-*` family so browsers can read them on cross-origin responses.  ## Quick Start 1. Get an API key at https://repull.dev/dashboard 2. Connect a PMS: `POST /v1/connect/{provider}` 3. List properties: `GET /v1/properties` 4. Get reservations: `GET /v1/reservations`  ## Authentication All requests require a Bearer token: ``` Authorization: Bearer sk_live_YOUR_API_KEY ```  ## Request Correlation (X-Request-ID) Every response carries an `X-Request-ID` header, e.g. `X-Request-ID: req_01HXY...`. Include this id in support tickets and bug reports — we can trace the full request lifecycle (auth, rate limit, handler, downstream calls, log row) from a single id.  You may set the header on the inbound request to forward your own trace id; we will echo it back instead of generating a new one. Accepted format: `^[\\\\w.-]{1,128}$`.  The id is also embedded in error envelopes as `request_id` so server-side log diffs work even when the response headers are stripped by an intermediate proxy.  ## Rate Limits The public API enforces a per-API-key sliding-window rate limit on top of the per-tier monthly + daily-AI quotas.  **Default policy:** 600 requests per 60 seconds, per API key. Sliding window — there is no fixed-minute boundary you can burst across.  Every response includes:  | Header | Meaning | |---|---| | `X-RateLimit-Limit` | Requests permitted in the current window. | | `X-RateLimit-Remaining` | Requests left in the current window after this call. | | `X-RateLimit-Reset` | Unix epoch (seconds) when the next slot opens. | | `X-RateLimit-Policy` | Machine-readable policy descriptor, e.g. `600;w=60`. | | `Retry-After` | Seconds to wait before retrying. **Only present on 429 responses.** |  **On 429 (rate_limit_exceeded):** the response body matches the standard error envelope with `code: \"rate_limit_exceeded\"`, plus `limit`, `window_seconds`, `retry_after`, and `request_id` fields. SDKs MUST honor `Retry-After` and use exponential backoff with jitter on subsequent retries — never a tight loop.  Recommended backoff: ``` sleep_ms = (Retry-After * 1000) + random(0..250) ```  Monthly + daily-AI tier quotas (`free`, `starter`, `custom`) are enforced separately and also surface as 429s; they include `tier`, `scope`, and `resetsAt` fields.  ## Plan Limits (402 — `listings_limit_exceeded`) The Repull API also enforces a per-tier cap on **active listings**:  | Tier | Active listings cap | |---|---| | `free` | 3 | | `starter` | 50 | | `custom` | unlimited |  When a customer's active-listing count is above their tier cap, the API returns **`402 Payment Required`** with `error.code = \"listings_limit_exceeded\"` on every route EXCEPT:  - `/v1/health` — uptime probes are never gated. - `/v1/usage/*` — so dashboards can render the over-cap state. - Any `DELETE` — so the customer can trim listings to get back under the cap without paying.  Unlike 429, 402 is NOT a \"wait and retry\" condition — `Retry-After` is not set. The only paths back to 200 are:   1. `DELETE` enough listings to come back under the cap, or   2. Upgrade at `https://repull.dev/dashboard/billing`. The server-side usage cache is 60s, so the first 200 after an upgrade may take up to a minute.  The envelope mirrors `rate_limit_exceeded` for SDK ergonomics: `tier`, `limit`, `active_listings`, `upgrade_url`, plus the standard `code` / `message` / `fix` / `docs_url` / `request_id`.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Repull
+  class AirbnbHostReviewSubmitCategoryRatingsInner < ApiModelBase
+    attr_accessor :category
+
+    attr_accessor :rating
+
+    # Optional note for this category (Airbnb caps it at 50 characters).
+    attr_accessor :comment
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'category' => :'category',
+        :'rating' => :'rating',
+        :'comment' => :'comment'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'category' => :'String',
+        :'rating' => :'Integer',
+        :'comment' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::AirbnbHostReviewSubmitCategoryRatingsInner` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::AirbnbHostReviewSubmitCategoryRatingsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'category')
+        self.category = attributes[:'category']
+      else
+        self.category = nil
+      end
+
+      if attributes.key?(:'rating')
+        self.rating = attributes[:'rating']
+      else
+        self.rating = nil
+      end
+
+      if attributes.key?(:'comment')
+        self.comment = attributes[:'comment']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @category.nil?
+        invalid_properties.push('invalid value for "category", category cannot be nil.')
+      end
+
+      if @rating.nil?
+        invalid_properties.push('invalid value for "rating", rating cannot be nil.')
+      end
+
+      if @rating > 5
+        invalid_properties.push('invalid value for "rating", must be smaller than or equal to 5.')
+      end
+
+      if @rating < 1
+        invalid_properties.push('invalid value for "rating", must be greater than or equal to 1.')
+      end
+
+      if !@comment.nil? && @comment.to_s.length > 50
+        invalid_properties.push('invalid value for "comment", the character length must be smaller than or equal to 50.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @category.nil?
+      category_validator = EnumAttributeValidator.new('String', ["cleanliness", "communication", "respect_house_rules"])
+      return false unless category_validator.valid?(@category)
+      return false if @rating.nil?
+      return false if @rating > 5
+      return false if @rating < 1
+      return false if !@comment.nil? && @comment.to_s.length > 50
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] category Object to be assigned
+    def category=(category)
+      validator = EnumAttributeValidator.new('String', ["cleanliness", "communication", "respect_house_rules"])
+      unless validator.valid?(category)
+        fail ArgumentError, "invalid value for \"category\", must be one of #{validator.allowable_values}."
+      end
+      @category = category
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] rating Value to be assigned
+    def rating=(rating)
+      if rating.nil?
+        fail ArgumentError, 'rating cannot be nil'
+      end
+
+      if rating > 5
+        fail ArgumentError, 'invalid value for "rating", must be smaller than or equal to 5.'
+      end
+
+      if rating < 1
+        fail ArgumentError, 'invalid value for "rating", must be greater than or equal to 1.'
+      end
+
+      @rating = rating
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] comment Value to be assigned
+    def comment=(comment)
+      if comment.nil?
+        fail ArgumentError, 'comment cannot be nil'
+      end
+
+      if comment.to_s.length > 50
+        fail ArgumentError, 'invalid value for "comment", the character length must be smaller than or equal to 50.'
+      end
+
+      @comment = comment
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          category == o.category &&
+          rating == o.rating &&
+          comment == o.comment
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [category, rating, comment].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/repull/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.22.0
 =end
 
 module Repull
-  VERSION = '0.2.22'
+  VERSION = '0.2.23'
 end

data/lib/repull.rb

@@ -46,6 +46,8 @@ require 'repull/models/airbnb_content_write_response'
 require 'repull/models/airbnb_data_freshness'
 require 'repull/models/airbnb_description_write_request'
 require 'repull/models/airbnb_description_write_request_description'
+require 'repull/models/airbnb_host_review_submit'
+require 'repull/models/airbnb_host_review_submit_category_ratings_inner'
 require 'repull/models/airbnb_listing'
 require 'repull/models/airbnb_listing_action200_response'
 require 'repull/models/airbnb_listing_action200_response_one_of'

data/openapi/v1.json

@@ -5636,6 +5636,82 @@
           }
         }
       },
+      "AirbnbHostReviewSubmit": {
+        "type": "object",
+        "description": "Your review of a guest. Airbnb requires `publicReview`, `isRevieweeRecommended`, and a rating for each of cleanliness, communication and respect_house_rules \u2014 through `rating`, `categoryRatings`, or both. Submitting publishes it and is final.",
+        "required": [
+          "publicReview",
+          "isRevieweeRecommended"
+        ],
+        "properties": {
+          "publicReview": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "Shown publicly on the guest's profile. `comment` is accepted as an alias.",
+            "example": "Joanne was a great guest. The space was kept clean and communication was clear."
+          },
+          "rating": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 5,
+            "description": "Used for every category not rated in `categoryRatings`.",
+            "example": 5
+          },
+          "categoryRatings": {
+            "type": "array",
+            "description": "Per-category scores. Categories not listed take `rating`; without `rating`, all three must be listed.",
+            "items": {
+              "type": "object",
+              "required": [
+                "category",
+                "rating"
+              ],
+              "properties": {
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "cleanliness",
+                    "communication",
+                    "respect_house_rules"
+                  ]
+                },
+                "rating": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "comment": {
+                  "type": "string",
+                  "maxLength": 50,
+                  "description": "Optional note for this category (Airbnb caps it at 50 characters)."
+                }
+              }
+            }
+          },
+          "privateFeedback": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "Optional. A note to the guest that is not published."
+          },
+          "isRevieweeRecommended": {
+            "type": "boolean",
+            "description": "Required. Whether you would host this guest again."
+          }
+        },
+        "example": {
+          "publicReview": "Joanne was a great guest. The space was kept clean and communication was clear.",
+          "rating": 5,
+          "categoryRatings": [
+            {
+              "category": "cleanliness",
+              "rating": 5,
+              "comment": "Left it spotless"
+            }
+          ],
+          "privateFeedback": "Thanks for being such a considerate guest!",
+          "isRevieweeRecommended": true
+        }
+      },
       "AirbnbReview": {
         "type": "object",
         "description": "An Airbnb review (guest \u2192 host or host \u2192 guest).",
@@ -18729,8 +18805,8 @@
     "/v1/channels/airbnb/reviews/{id}": {
       "put": {
         "operationId": "edit_airbnb_review",
-        "summary": "Edit Airbnb host review",
-        "description": "Edit a host-side review for an Airbnb stay. Airbnb collapses POST + PUT into the same upstream call (`PUT /v2/listing_reviews/{id}`), so this endpoint covers both initial submit and subsequent edits while the review window is open.\n\nBody is a partial `AirbnbReview` \u2014 pass the fields you want to change (rating, public review, private feedback, category ratings).\n\nReturns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "summary": "Submit your review of a guest (publishes, final)",
+        "description": "Submit your review of a guest \u2014 the review with `reviewerRole: \"host\"`. **Submitting publishes it and is final:** Airbnb has no draft and does not allow edits; a second submission is `409 review_already_submitted`. Airbnb accepts it up to 14 days after checkout (`expiresAt`).\n\nRequired: `publicReview`, `isRevieweeRecommended` (whether you would host the guest again), and a 1\u20135 rating for **each** of `cleanliness`, `communication` and `respect_house_rules` \u2014 send `rating` to use one score for all three, `categoryRatings` to score them individually, or both (`rating` fills any category you did not rate). Optional: `privateFeedback`, a note to the guest that is not published. A request missing a required piece is refused with `422 invalid_params` naming it, before anything is sent to Airbnb.\n\n```json\n{\n  \"publicReview\": \"Joanne was a great guest.\",\n  \"rating\": 5,\n  \"privateFeedback\": \"Thanks for leaving the place so tidy!\",\n  \"isRevieweeRecommended\": true\n}\n```\n\nA guest's review of you (`reviewerRole: \"guest\"`) cannot be written here \u2014 `409 not_host_review`; reply to it with `POST /v1/channels/airbnb/reviews/{id}/respond`. After the window closes: `409 review_window_closed`. Full guide: https://repull.dev/docs/channels/airbnb/reviews",
         "tags": [
           "Airbnb"
         ],
@@ -18742,7 +18818,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Airbnb review id (`HRabc123` style)."
+            "description": "The review's `id` or `externalReviewId`, both as returned by `GET /v1/reviews`."
           }
         ],
         "requestBody": {
@@ -18750,7 +18826,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/AirbnbReview"
+                "$ref": "#/components/schemas/AirbnbHostReviewSubmit"
               }
             }
           }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: repull
 version: !ruby/object:Gem::Version
-  version: 0.2.22
+  version: 0.2.23
 platform: ruby
 authors:
 - Ivan Nikolov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-27 00:00:00.000000000 Z
+date: 2026-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -121,6 +121,8 @@ files:
 - lib/repull/models/airbnb_data_freshness.rb
 - lib/repull/models/airbnb_description_write_request.rb
 - lib/repull/models/airbnb_description_write_request_description.rb
+- lib/repull/models/airbnb_host_review_submit.rb
+- lib/repull/models/airbnb_host_review_submit_category_ratings_inner.rb
 - lib/repull/models/airbnb_listing.rb
 - lib/repull/models/airbnb_listing_action200_response.rb
 - lib/repull/models/airbnb_listing_action200_response_one_of.rb