repull 0.2.10 → 0.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (453) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/repull/api/airbnb_api.rb +1569 -196
  4. data/lib/repull/api/atlas_api.rb +5 -5
  5. data/lib/repull/api/availability_api.rb +145 -3
  6. data/lib/repull/api/billing_api.rb +7 -7
  7. data/lib/repull/api/booking_com_api.rb +210 -54
  8. data/lib/repull/api/connect_api.rb +763 -10
  9. data/lib/repull/api/conversations_api.rb +92 -11
  10. data/lib/repull/api/guests_api.rb +82 -7
  11. data/lib/repull/api/health_api.rb +318 -0
  12. data/lib/repull/api/kv_api.rb +1 -1
  13. data/lib/repull/api/listings_api.rb +392 -29
  14. data/lib/repull/api/markets_api.rb +3 -3
  15. data/lib/repull/api/plumguide_api.rb +19 -11
  16. data/lib/repull/api/pricing_api.rb +15 -15
  17. data/lib/repull/api/properties_api.rb +12 -9
  18. data/lib/repull/api/quotes_api.rb +109 -0
  19. data/lib/repull/api/reservations_api.rb +166 -7
  20. data/lib/repull/api/reviews_api.rb +81 -7
  21. data/lib/repull/api/schema_api.rb +1 -1
  22. data/lib/repull/api/system_api.rb +1 -1
  23. data/lib/repull/api/vrbo_api.rb +10 -10
  24. data/lib/repull/api/webhooks_api.rb +11 -9
  25. data/lib/repull/api_client.rb +1 -1
  26. data/lib/repull/api_error.rb +1 -1
  27. data/lib/repull/api_model_base.rb +1 -1
  28. data/lib/repull/configuration.rb +1 -1
  29. data/lib/repull/models/account_created_event.rb +1 -1
  30. data/lib/repull/models/account_created_payload.rb +1 -1
  31. data/lib/repull/models/account_disconnected_event.rb +1 -1
  32. data/lib/repull/models/account_disconnected_payload.rb +1 -1
  33. data/lib/repull/models/acknowledge_booking_reservations_request.rb +1 -1
  34. data/lib/repull/models/ai_operation.rb +1 -1
  35. data/lib/repull/models/ai_operation_completed_event.rb +1 -1
  36. data/lib/repull/models/ai_operation_completed_payload.rb +1 -1
  37. data/lib/repull/models/ai_operation_failed_event.rb +1 -1
  38. data/lib/repull/models/ai_operation_failed_payload.rb +1 -1
  39. data/lib/repull/models/ai_operation_failed_payload_error.rb +1 -1
  40. data/lib/repull/models/airbnb_account_freshness.rb +239 -0
  41. data/lib/repull/models/airbnb_alteration.rb +198 -10
  42. data/lib/repull/models/airbnb_alteration_create_request.rb +264 -0
  43. data/lib/repull/models/airbnb_amenity.rb +1 -1
  44. data/lib/repull/models/airbnb_availability_write_request.rb +20 -1
  45. data/lib/repull/models/airbnb_calendar_operation.rb +97 -8
  46. data/lib/repull/models/airbnb_connection.rb +73 -6
  47. data/lib/repull/models/airbnb_connection_accessibility_amenities_inner.rb +1 -1
  48. data/lib/repull/models/airbnb_connection_amenities_inner.rb +1 -1
  49. data/lib/repull/models/airbnb_connection_host.rb +2 -2
  50. data/lib/repull/models/airbnb_connection_response.rb +1 -1
  51. data/lib/repull/models/airbnb_connection_summary.rb +1 -1
  52. data/lib/repull/models/airbnb_content_write_response.rb +275 -0
  53. data/lib/repull/models/airbnb_data_freshness.rb +24 -12
  54. data/lib/repull/models/airbnb_description_write_request.rb +192 -0
  55. data/lib/repull/models/airbnb_description_write_request_description.rb +365 -0
  56. data/lib/repull/models/airbnb_listing.rb +14 -3
  57. data/lib/repull/models/airbnb_listing_action200_response.rb +105 -0
  58. data/lib/repull/models/airbnb_listing_action200_response_one_of.rb +157 -0
  59. data/lib/repull/models/airbnb_listing_action200_response_one_of1.rb +175 -0
  60. data/lib/repull/models/airbnb_listing_action_request.rb +3 -3
  61. data/lib/repull/models/airbnb_listing_details_response.rb +284 -0
  62. data/lib/repull/models/airbnb_listing_details_write_request.rb +209 -0
  63. data/lib/repull/models/airbnb_listing_details_write_request_check_in_option.rb +214 -0
  64. data/lib/repull/models/airbnb_listing_details_write_request_quiet_hours_inner.rb +190 -0
  65. data/lib/repull/models/airbnb_listing_lifecycle_response.rb +196 -0
  66. data/lib/repull/models/airbnb_listing_list_response.rb +2 -2
  67. data/lib/repull/models/airbnb_permits_response.rb +163 -0
  68. data/lib/repull/models/airbnb_permits_response_cached_inner.rb +200 -0
  69. data/lib/repull/models/airbnb_permits_write_request.rb +176 -0
  70. data/lib/repull/models/airbnb_permits_write_request_permits_inner.rb +228 -0
  71. data/lib/repull/models/airbnb_permits_write_request_permits_inner_answers_inner.rb +198 -0
  72. data/lib/repull/models/airbnb_photo_position.rb +159 -0
  73. data/lib/repull/models/airbnb_pricing_write_request.rb +54 -3
  74. data/lib/repull/models/airbnb_pricing_write_request_records_inner.rb +236 -0
  75. data/lib/repull/models/airbnb_publish_result.rb +263 -0
  76. data/lib/repull/models/airbnb_reservation.rb +24 -2
  77. data/lib/repull/models/airbnb_reservation_list_response.rb +15 -6
  78. data/lib/repull/models/airbnb_review.rb +24 -2
  79. data/lib/repull/models/airbnb_review_list_response.rb +14 -5
  80. data/lib/repull/models/airbnb_safety_disclosure.rb +202 -0
  81. data/lib/repull/models/airbnb_safety_disclosures_response.rb +162 -0
  82. data/lib/repull/models/airbnb_safety_disclosures_write_request.rb +176 -0
  83. data/lib/repull/models/airbnb_thread.rb +24 -2
  84. data/lib/repull/models/airbnb_thread_list_response.rb +14 -5
  85. data/lib/repull/models/airbnb_transaction.rb +524 -0
  86. data/lib/repull/models/airbnb_transaction_guest_breakdown.rb +171 -0
  87. data/lib/repull/models/airbnb_transaction_host_breakdown.rb +246 -0
  88. data/lib/repull/models/airbnb_transaction_payout.rb +175 -0
  89. data/lib/repull/models/alteration_change.rb +161 -0
  90. data/lib/repull/models/alteration_webhook_object.rb +296 -0
  91. data/lib/repull/models/availability_batch_write_request.rb +296 -0
  92. data/lib/repull/models/availability_write_request.rb +259 -0
  93. data/lib/repull/models/availability_write_result.rb +178 -0
  94. data/lib/repull/models/availability_write_result_synced.rb +176 -0
  95. data/lib/repull/models/availability_write_settings.rb +215 -0
  96. data/lib/repull/models/booking_availability_state_response.rb +149 -0
  97. data/lib/repull/models/booking_availability_update.rb +1 -1
  98. data/lib/repull/models/booking_availability_update_request.rb +1 -1
  99. data/lib/repull/models/booking_availability_update_request_property_id.rb +1 -1
  100. data/lib/repull/models/booking_availability_update_request_updates_inner.rb +1 -1
  101. data/lib/repull/models/booking_connect_listing_option.rb +1 -1
  102. data/lib/repull/models/booking_connect_room.rb +1 -1
  103. data/lib/repull/models/booking_connect_rooms_response.rb +39 -5
  104. data/lib/repull/models/booking_conversation.rb +1 -1
  105. data/lib/repull/models/booking_pricing_rate_update.rb +1 -1
  106. data/lib/repull/models/booking_pricing_rate_update_date_range.rb +1 -1
  107. data/lib/repull/models/booking_pricing_rate_update_restrictions.rb +1 -1
  108. data/lib/repull/models/booking_pricing_response.rb +1 -1
  109. data/lib/repull/models/booking_pricing_update_request.rb +1 -1
  110. data/lib/repull/models/booking_pricing_update_response.rb +1 -1
  111. data/lib/repull/models/booking_property.rb +1 -1
  112. data/lib/repull/models/booking_reservation.rb +277 -0
  113. data/lib/repull/models/booking_reservation_room.rb +271 -0
  114. data/lib/repull/models/booking_room_mapping.rb +18 -8
  115. data/lib/repull/models/booking_rooms_rates_response.rb +170 -0
  116. data/lib/repull/models/booking_rooms_rates_response_rooms_inner.rb +170 -0
  117. data/lib/repull/models/booking_rooms_rates_response_rooms_inner_rates_inner.rb +212 -0
  118. data/lib/repull/models/booking_setup_request.rb +1 -1
  119. data/lib/repull/models/booking_verify_hotel_request.rb +1 -1
  120. data/lib/repull/models/booking_verify_hotel_response.rb +40 -6
  121. data/lib/repull/models/bulk_pricing_failure.rb +1 -1
  122. data/lib/repull/models/bulk_pricing_item.rb +1 -1
  123. data/lib/repull/models/bulk_pricing_request.rb +1 -1
  124. data/lib/repull/models/bulk_pricing_response.rb +1 -1
  125. data/lib/repull/models/calendar_day.rb +1 -1
  126. data/lib/repull/models/calendar_response.rb +1 -1
  127. data/lib/repull/models/calendar_updated_event.rb +1 -1
  128. data/lib/repull/models/calendar_updated_payload.rb +1 -1
  129. data/lib/repull/models/calendar_updated_payload_range.rb +1 -1
  130. data/lib/repull/models/clear_kv200_response.rb +1 -1
  131. data/lib/repull/models/connect_host.rb +1 -1
  132. data/lib/repull/models/connect_provider.rb +1 -1
  133. data/lib/repull/models/connect_provider_list_response.rb +1 -1
  134. data/lib/repull/models/connect_session.rb +1 -1
  135. data/lib/repull/models/connect_status.rb +18 -6
  136. data/lib/repull/models/connect_status_accounts_inner.rb +188 -0
  137. data/lib/repull/models/connection.rb +1 -1
  138. data/lib/repull/models/connection_list_response.rb +1 -1
  139. data/lib/repull/models/conversation.rb +13 -2
  140. data/lib/repull/models/conversation_detail.rb +13 -2
  141. data/lib/repull/models/conversation_guest.rb +1 -1
  142. data/lib/repull/models/conversation_guest_contact.rb +1 -1
  143. data/lib/repull/models/conversation_host.rb +1 -1
  144. data/lib/repull/models/conversation_list_response.rb +1 -1
  145. data/lib/repull/models/conversation_message_attachment.rb +1 -1
  146. data/lib/repull/models/create_airbnb_listing_room_request.rb +315 -0
  147. data/lib/repull/models/create_airbnb_offer_request.rb +1 -1
  148. data/lib/repull/models/create_billing_checkout_request.rb +1 -1
  149. data/lib/repull/models/create_booking_webhook_request.rb +1 -1
  150. data/lib/repull/models/create_connect_session_request.rb +1 -1
  151. data/lib/repull/models/create_connection_request.rb +2 -2
  152. data/lib/repull/models/create_webhook_request.rb +1 -1
  153. data/lib/repull/models/custom_schema.rb +1 -1
  154. data/lib/repull/models/custom_schema_create.rb +1 -1
  155. data/lib/repull/models/custom_schema_create_response.rb +1 -1
  156. data/lib/repull/models/custom_schema_delete_response.rb +1 -1
  157. data/lib/repull/models/custom_schema_list_response.rb +1 -1
  158. data/lib/repull/models/custom_schema_summary.rb +1 -1
  159. data/lib/repull/models/custom_schema_update.rb +1 -1
  160. data/lib/repull/models/delete_airbnb_listing_photo200_response.rb +15 -5
  161. data/lib/repull/models/delete_airbnb_listing_room200_response.rb +157 -0
  162. data/lib/repull/models/delete_connection200_response.rb +234 -0
  163. data/lib/repull/models/delete_kv200_response.rb +1 -1
  164. data/lib/repull/models/error.rb +1 -1
  165. data/lib/repull/models/error_error.rb +44 -2
  166. data/lib/repull/models/error_error_support.rb +1 -1
  167. data/lib/repull/models/get_airbnb_alteration200_response.rb +2 -2
  168. data/lib/repull/models/get_airbnb_booking_settings200_response.rb +190 -0
  169. data/lib/repull/models/get_airbnb_booking_settings200_response_data.rb +246 -0
  170. data/lib/repull/models/get_airbnb_booking_settings200_response_data_advance_notice.rb +172 -0
  171. data/lib/repull/models/get_airbnb_booking_settings200_response_data_booking_window.rb +160 -0
  172. data/lib/repull/models/get_airbnb_booking_settings200_response_data_cancellation.rb +203 -0
  173. data/lib/repull/models/get_airbnb_booking_settings200_response_data_cancellation_non_refundable.rb +218 -0
  174. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_in.rb +159 -0
  175. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_in_start.rb +104 -0
  176. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_out.rb +172 -0
  177. data/lib/repull/models/get_airbnb_booking_settings200_response_data_instant_book.rb +206 -0
  178. data/lib/repull/models/get_airbnb_booking_settings200_response_data_preparation_time.rb +173 -0
  179. data/lib/repull/models/get_airbnb_checkin_guide200_response.rb +192 -0
  180. data/lib/repull/models/get_airbnb_listing_details200_response.rb +192 -0
  181. data/lib/repull/models/get_airbnb_listing_quality200_response.rb +2 -2
  182. data/lib/repull/models/get_airbnb_listing_settings200_response.rb +2 -2
  183. data/lib/repull/models/get_airbnb_thread200_response.rb +2 -2
  184. data/lib/repull/models/get_health200_response.rb +1 -1
  185. data/lib/repull/models/get_usage_logs200_response.rb +1 -1
  186. data/lib/repull/models/get_usage_logs200_response_data_inner.rb +1 -1
  187. data/lib/repull/models/get_usage_logs200_response_pagination.rb +3 -3
  188. data/lib/repull/models/get_usage_summary200_response.rb +2 -2
  189. data/lib/repull/models/get_usage_summary200_response_breakdown_inner.rb +1 -1
  190. data/lib/repull/models/get_usage_summary200_response_limits.rb +3 -3
  191. data/lib/repull/models/get_usage_summary200_response_remaining.rb +2 -2
  192. data/lib/repull/models/get_usage_summary200_response_status_distribution.rb +1 -1
  193. data/lib/repull/models/get_usage_summary200_response_timeline_inner.rb +1 -1
  194. data/lib/repull/models/get_usage_summary200_response_totals.rb +1 -1
  195. data/lib/repull/models/get_usage_summary200_response_used.rb +2 -2
  196. data/lib/repull/models/get_usage_tier200_response.rb +2 -2
  197. data/lib/repull/models/get_usage_tier200_response_limits.rb +4 -4
  198. data/lib/repull/models/get_usage_tier200_response_remaining.rb +3 -3
  199. data/lib/repull/models/get_usage_tier200_response_used.rb +3 -3
  200. data/lib/repull/models/guest.rb +1 -1
  201. data/lib/repull/models/guest_contact.rb +1 -1
  202. data/lib/repull/models/guest_create_request.rb +250 -0
  203. data/lib/repull/models/guest_create_response.rb +227 -0
  204. data/lib/repull/models/guest_create_response_contacts_inner.rb +199 -0
  205. data/lib/repull/models/guest_flag.rb +1 -1
  206. data/lib/repull/models/guest_list_response.rb +1 -1
  207. data/lib/repull/models/guest_note.rb +1 -1
  208. data/lib/repull/models/guest_profile.rb +1 -1
  209. data/lib/repull/models/guest_reservations_summary.rb +1 -1
  210. data/lib/repull/models/list_airbnb_alterations200_response.rb +2 -2
  211. data/lib/repull/models/list_airbnb_listing_amenities200_response.rb +2 -2
  212. data/lib/repull/models/list_airbnb_listing_amenities200_response_data.rb +1 -1
  213. data/lib/repull/models/list_airbnb_listing_permits200_response.rb +190 -0
  214. data/lib/repull/models/list_airbnb_listing_safety_disclosures200_response.rb +190 -0
  215. data/lib/repull/models/list_airbnb_transactions200_response.rb +3 -3
  216. data/lib/repull/models/list_booking_reservations200_response.rb +104 -0
  217. data/lib/repull/models/list_kv200_response.rb +1 -1
  218. data/lib/repull/models/list_kv200_response_data_inner.rb +1 -1
  219. data/lib/repull/models/list_kv200_response_pagination.rb +2 -2
  220. data/lib/repull/models/listing.rb +3 -2
  221. data/lib/repull/models/listing_active_request.rb +2 -2
  222. data/lib/repull/models/listing_active_response.rb +1 -1
  223. data/lib/repull/models/listing_address.rb +1 -1
  224. data/lib/repull/models/listing_amenity.rb +1 -1
  225. data/lib/repull/models/listing_channel.rb +1 -1
  226. data/lib/repull/models/listing_comp.rb +1 -1
  227. data/lib/repull/models/listing_comp_nightly.rb +1 -1
  228. data/lib/repull/models/listing_comp_ratings.rb +1 -1
  229. data/lib/repull/models/listing_comps_response.rb +1 -1
  230. data/lib/repull/models/listing_content.rb +14 -3
  231. data/lib/repull/models/listing_content_update_request.rb +22 -3
  232. data/lib/repull/models/listing_content_update_request_address.rb +1 -1
  233. data/lib/repull/models/listing_content_update_request_amenities.rb +1 -1
  234. data/lib/repull/models/listing_content_update_request_amenities_one_of_inner.rb +1 -1
  235. data/lib/repull/models/listing_content_update_request_details.rb +206 -0
  236. data/lib/repull/models/listing_content_update_request_occupancy.rb +1 -1
  237. data/lib/repull/models/listing_content_update_request_photos_inner.rb +1 -1
  238. data/lib/repull/models/listing_content_update_request_photos_inner_one_of.rb +1 -1
  239. data/lib/repull/models/listing_content_update_request_policies.rb +96 -6
  240. data/lib/repull/models/listing_content_update_response.rb +2 -2
  241. data/lib/repull/models/listing_create_request.rb +1 -1
  242. data/lib/repull/models/listing_create_response.rb +1 -1
  243. data/lib/repull/models/listing_created_event.rb +1 -1
  244. data/lib/repull/models/listing_created_payload.rb +1 -1
  245. data/lib/repull/models/listing_created_payload_address.rb +1 -1
  246. data/lib/repull/models/listing_deleted_event.rb +1 -1
  247. data/lib/repull/models/listing_deleted_payload.rb +1 -1
  248. data/lib/repull/models/listing_details.rb +1 -1
  249. data/lib/repull/models/listing_generate_content_request.rb +1 -1
  250. data/lib/repull/models/listing_generate_content_response.rb +1 -1
  251. data/lib/repull/models/listing_list_response.rb +1 -1
  252. data/lib/repull/models/{studio_file.rb → listing_photo.rb} +23 -34
  253. data/lib/repull/models/listing_photo_delete_request.rb +165 -0
  254. data/lib/repull/models/{studio_error.rb → listing_photo_delete_response.rb} +20 -12
  255. data/lib/repull/models/listing_photo_upload_url_request.rb +203 -0
  256. data/lib/repull/models/listing_photo_upload_url_response.rb +198 -0
  257. data/lib/repull/models/{vrbo_listing_list_response.rb → listing_photos_response.rb} +19 -19
  258. data/lib/repull/models/listing_pricing_apply_request.rb +1 -1
  259. data/lib/repull/models/listing_pricing_apply_response.rb +1 -1
  260. data/lib/repull/models/listing_pricing_history_entry.rb +2 -2
  261. data/lib/repull/models/listing_pricing_history_response.rb +1 -1
  262. data/lib/repull/models/listing_pricing_recommendation.rb +1 -1
  263. data/lib/repull/models/listing_pricing_response.rb +1 -1
  264. data/lib/repull/models/listing_pricing_response_comp_summary.rb +1 -1
  265. data/lib/repull/models/listing_pricing_response_date_range.rb +1 -1
  266. data/lib/repull/models/listing_pricing_response_listing.rb +1 -1
  267. data/lib/repull/models/listing_pricing_strategy.rb +1 -1
  268. data/lib/repull/models/listing_pricing_strategy_input.rb +1 -1
  269. data/lib/repull/models/listing_publish_airbnb_request.rb +1 -1
  270. data/lib/repull/models/listing_publish_airbnb_response.rb +165 -0
  271. data/lib/repull/models/listing_publish_response.rb +1 -1
  272. data/lib/repull/models/listing_publish_status_channel.rb +1 -1
  273. data/lib/repull/models/listing_publish_status_connection.rb +1 -1
  274. data/lib/repull/models/listing_publish_status_response.rb +1 -1
  275. data/lib/repull/models/listing_pull_airbnb_request.rb +149 -0
  276. data/lib/repull/models/listing_pull_response.rb +231 -0
  277. data/lib/repull/models/listing_quality_tier.rb +1 -1
  278. data/lib/repull/models/listing_segment.rb +1 -1
  279. data/lib/repull/models/listing_segment_recommendation.rb +1 -1
  280. data/lib/repull/models/listing_segments_response.rb +1 -1
  281. data/lib/repull/models/listing_segments_response_scope.rb +1 -1
  282. data/lib/repull/models/listing_status_batch_request.rb +212 -0
  283. data/lib/repull/models/{sandbox_reset_result.rb → listing_status_batch_response.rb} +57 -51
  284. data/lib/repull/models/listing_updated_event.rb +1 -1
  285. data/lib/repull/models/listing_updated_payload.rb +1 -1
  286. data/lib/repull/models/map_airbnb_listing_request.rb +1 -1
  287. data/lib/repull/models/map_airbnb_listing_response.rb +1 -1
  288. data/lib/repull/models/map_connect_booking_rooms_request.rb +1 -1
  289. data/lib/repull/models/map_connect_booking_rooms_response.rb +16 -5
  290. data/lib/repull/models/market_browse_category.rb +1 -1
  291. data/lib/repull/models/market_browse_entry.rb +1 -1
  292. data/lib/repull/models/market_browse_featured.rb +1 -1
  293. data/lib/repull/models/market_browse_response.rb +1 -1
  294. data/lib/repull/models/market_calendar_day.rb +1 -1
  295. data/lib/repull/models/market_calendar_day_events_inner.rb +1 -1
  296. data/lib/repull/models/market_calendar_response.rb +1 -1
  297. data/lib/repull/models/market_detail_response.rb +1 -1
  298. data/lib/repull/models/market_detail_response_price_distribution_inner.rb +1 -1
  299. data/lib/repull/models/market_detail_response_property_type_mix_inner.rb +1 -1
  300. data/lib/repull/models/market_detail_response_supply_trend_inner.rb +1 -1
  301. data/lib/repull/models/market_detail_response_top_comps.rb +1 -1
  302. data/lib/repull/models/market_event.rb +1 -1
  303. data/lib/repull/models/market_my_listing.rb +1 -1
  304. data/lib/repull/models/market_summary.rb +1 -1
  305. data/lib/repull/models/market_top_comp.rb +1 -1
  306. data/lib/repull/models/markets_overview_response.rb +1 -1
  307. data/lib/repull/models/markets_overview_response_browse.rb +1 -1
  308. data/lib/repull/models/markets_overview_response_subscriptions.rb +1 -1
  309. data/lib/repull/models/markets_overview_response_totals.rb +1 -1
  310. data/lib/repull/models/message.rb +1 -1
  311. data/lib/repull/models/message_list_response.rb +1 -1
  312. data/lib/repull/models/pagination.rb +1 -1
  313. data/lib/repull/models/payment_completed_event.rb +1 -1
  314. data/lib/repull/models/payment_completed_payload.rb +1 -1
  315. data/lib/repull/models/payment_refunded_event.rb +1 -1
  316. data/lib/repull/models/payment_refunded_payload.rb +1 -1
  317. data/lib/repull/models/plumguide_listing.rb +1 -1
  318. data/lib/repull/models/plumguide_listing_list_response.rb +1 -1
  319. data/lib/repull/models/property.rb +17 -7
  320. data/lib/repull/models/property_availability.rb +33 -7
  321. data/lib/repull/models/property_availability_coverage.rb +222 -0
  322. data/lib/repull/models/property_availability_day.rb +4 -4
  323. data/lib/repull/models/property_list_response.rb +1 -1
  324. data/lib/repull/models/{studio_error_error.rb → publish_section_error.rb} +56 -36
  325. data/lib/repull/models/quote.rb +240 -0
  326. data/lib/repull/models/quote_pricing.rb +218 -0
  327. data/lib/repull/models/reorder_airbnb_listing_photos200_response.rb +191 -0
  328. data/lib/repull/models/reorder_airbnb_listing_photos200_response_data.rb +172 -0
  329. data/lib/repull/models/reorder_airbnb_listing_photos_request.rb +185 -0
  330. data/lib/repull/models/reply_booking_review200_response.rb +1 -1
  331. data/lib/repull/models/reply_booking_review_request.rb +1 -1
  332. data/lib/repull/models/reply_to_review201_response.rb +165 -0
  333. data/lib/repull/models/reply_to_review_request.rb +165 -0
  334. data/lib/repull/models/repull_ping_event.rb +1 -1
  335. data/lib/repull/models/repull_ping_payload.rb +1 -1
  336. data/lib/repull/models/reservation.rb +24 -2
  337. data/lib/repull/models/{studio_deployment.rb → reservation_alteration_created_event.rb} +67 -57
  338. data/lib/repull/models/reservation_alteration_created_payload.rb +177 -0
  339. data/lib/repull/models/reservation_alteration_responded_event.rb +217 -0
  340. data/lib/repull/models/reservation_alteration_responded_payload.rb +175 -0
  341. data/lib/repull/models/reservation_cancelled_event.rb +1 -1
  342. data/lib/repull/models/reservation_cancelled_payload.rb +1 -1
  343. data/lib/repull/models/reservation_create_request.rb +403 -0
  344. data/lib/repull/models/{create_airbnb_alteration_request.rb → reservation_create_response.rb} +73 -35
  345. data/lib/repull/models/reservation_created_event.rb +1 -1
  346. data/lib/repull/models/reservation_created_payload.rb +1 -1
  347. data/lib/repull/models/reservation_financials.rb +36 -8
  348. data/lib/repull/models/reservation_guest_financials.rb +173 -0
  349. data/lib/repull/models/reservation_guest_input.rb +193 -0
  350. data/lib/repull/models/reservation_host_financials.rb +207 -0
  351. data/lib/repull/models/reservation_list_response.rb +1 -1
  352. data/lib/repull/models/reservation_message_received_event.rb +1 -1
  353. data/lib/repull/models/reservation_message_received_payload.rb +1 -1
  354. data/lib/repull/models/reservation_message_received_payload_from.rb +1 -1
  355. data/lib/repull/models/reservation_money_line.rb +216 -0
  356. data/lib/repull/models/reservation_occupancy.rb +1 -1
  357. data/lib/repull/models/reservation_primary_guest.rb +1 -1
  358. data/lib/repull/models/reservation_update_request.rb +255 -0
  359. data/lib/repull/models/reservation_update_response.rb +240 -0
  360. data/lib/repull/models/reservation_updated_event.rb +1 -1
  361. data/lib/repull/models/reservation_updated_payload.rb +1 -1
  362. data/lib/repull/models/reservation_webhook_object.rb +39 -6
  363. data/lib/repull/models/respond_airbnb_review_request.rb +1 -1
  364. data/lib/repull/models/review.rb +14 -3
  365. data/lib/repull/models/review_category.rb +1 -1
  366. data/lib/repull/models/review_created_event.rb +217 -0
  367. data/lib/repull/models/review_created_payload.rb +165 -0
  368. data/lib/repull/models/review_list_response.rb +1 -1
  369. data/lib/repull/models/review_responded_event.rb +217 -0
  370. data/lib/repull/models/review_responded_payload.rb +175 -0
  371. data/lib/repull/models/review_response.rb +1 -1
  372. data/lib/repull/models/review_webhook_object.rb +277 -0
  373. data/lib/repull/models/rotate_webhook_secret200_response.rb +1 -1
  374. data/lib/repull/models/select_connect_provider_request.rb +1 -1
  375. data/lib/repull/models/select_provider_response.rb +1 -1
  376. data/lib/repull/models/send_airbnb_message_request.rb +187 -0
  377. data/lib/repull/models/{sandbox_reset_result_deleted.rb → send_booking_message_request.rb} +53 -50
  378. data/lib/repull/models/send_message_request.rb +193 -0
  379. data/lib/repull/models/send_message_response.rb +241 -0
  380. data/lib/repull/models/set_airbnb_listing_cover_photo200_response.rb +191 -0
  381. data/lib/repull/models/set_airbnb_listing_cover_photo200_response_data.rb +171 -0
  382. data/lib/repull/models/set_airbnb_listing_cover_photo_request.rb +165 -0
  383. data/lib/repull/models/set_kv_request.rb +1 -1
  384. data/lib/repull/models/{booking_property_list_response.rb → submit_beds24_credentials200_response.rb} +19 -19
  385. data/lib/repull/models/submit_beds24_credentials_request.rb +177 -0
  386. data/lib/repull/models/submit_bookingsync_credentials_request.rb +177 -0
  387. data/lib/repull/models/submit_guesty_credentials_request.rb +177 -0
  388. data/lib/repull/models/submit_hospitable_credentials_request.rb +177 -0
  389. data/lib/repull/models/submit_hostaway_credentials_request.rb +177 -0
  390. data/lib/repull/models/submit_igms_credentials_request.rb +177 -0
  391. data/lib/repull/models/submit_lodgify_credentials_request.rb +177 -0
  392. data/lib/repull/models/submit_ownerrez_credentials_request.rb +177 -0
  393. data/lib/repull/models/submit_smoobu_credentials_request.rb +177 -0
  394. data/lib/repull/models/submit_vrbo_credentials_request.rb +177 -0
  395. data/lib/repull/models/sync_airbnb_transactions200_response.rb +191 -0
  396. data/lib/repull/models/sync_airbnb_transactions_request.rb +201 -0
  397. data/lib/repull/models/test_webhook_request.rb +1 -1
  398. data/lib/repull/models/{booking_conversation_list_response.rb → update_airbnb_booking_settings200_response.rb} +26 -20
  399. data/lib/repull/models/update_airbnb_booking_settings200_response_data.rb +205 -0
  400. data/lib/repull/models/update_airbnb_booking_settings_request.rb +202 -0
  401. data/lib/repull/models/update_airbnb_booking_settings_request_advance_notice.rb +183 -0
  402. data/lib/repull/models/update_airbnb_booking_settings_request_booking_window.rb +183 -0
  403. data/lib/repull/models/update_airbnb_booking_settings_request_cancellation.rb +201 -0
  404. data/lib/repull/models/update_airbnb_booking_settings_request_cancellation_non_refundable.rb +183 -0
  405. data/lib/repull/models/update_airbnb_booking_settings_request_check_in.rb +159 -0
  406. data/lib/repull/models/update_airbnb_booking_settings_request_check_out.rb +182 -0
  407. data/lib/repull/models/update_airbnb_booking_settings_request_instant_book.rb +203 -0
  408. data/lib/repull/models/update_airbnb_booking_settings_request_preparation_time.rb +182 -0
  409. data/lib/repull/models/update_airbnb_listing_amenities200_response.rb +191 -0
  410. data/lib/repull/models/update_airbnb_listing_amenities200_response_data.rb +158 -0
  411. data/lib/repull/models/update_airbnb_listing_amenities_request.rb +199 -0
  412. data/lib/repull/models/update_airbnb_listing_amenities_request_accessibility_amenities_inner.rb +246 -0
  413. data/lib/repull/models/update_airbnb_listing_amenities_request_amenities_inner.rb +218 -0
  414. data/lib/repull/models/update_airbnb_listing_permits200_response.rb +168 -0
  415. data/lib/repull/models/update_airbnb_listing_photo200_response.rb +194 -0
  416. data/lib/repull/models/update_airbnb_listing_photo_request.rb +242 -0
  417. data/lib/repull/models/update_airbnb_listing_room200_response.rb +194 -0
  418. data/lib/repull/models/update_airbnb_listing_room_request.rb +293 -0
  419. data/lib/repull/models/update_airbnb_listing_room_request_beds_inner.rb +209 -0
  420. data/lib/repull/models/{sandbox_fixture_ref.rb → update_airbnb_listing_room_request_room_amenities_inner.rb} +26 -37
  421. data/lib/repull/models/update_airbnb_listing_room_request_room_amenities_inner_value.rb +105 -0
  422. data/lib/repull/models/update_airbnb_listing_safety_disclosures200_response.rb +180 -0
  423. data/lib/repull/models/update_airbnb_message_request.rb +1 -1
  424. data/lib/repull/models/update_booking_charges_request.rb +1 -1
  425. data/lib/repull/models/update_listing_pricing_strategy200_response.rb +1 -1
  426. data/lib/repull/models/update_webhook_request.rb +1 -1
  427. data/lib/repull/models/upload_airbnb_listing_photos_request.rb +184 -0
  428. data/lib/repull/models/upload_airbnb_listing_photos_request_photos_inner.rb +305 -0
  429. data/lib/repull/models/upload_airbnb_listing_photos_request_photos_inner_listing_id.rb +105 -0
  430. data/lib/repull/models/vrbo_listing.rb +1 -1
  431. data/lib/repull/models/vrbo_reservation.rb +1 -1
  432. data/lib/repull/models/vrbo_reservation_list_response.rb +1 -1
  433. data/lib/repull/models/webhook_delivery.rb +1 -1
  434. data/lib/repull/models/webhook_delivery_detail.rb +1 -1
  435. data/lib/repull/models/webhook_delivery_list_response.rb +1 -1
  436. data/lib/repull/models/webhook_event.rb +12 -4
  437. data/lib/repull/models/webhook_event_catalog.rb +1 -1
  438. data/lib/repull/models/webhook_event_catalog_domains_inner.rb +1 -1
  439. data/lib/repull/models/webhook_event_catalog_entry.rb +1 -1
  440. data/lib/repull/models/webhook_event_type.rb +6 -2
  441. data/lib/repull/models/webhook_list_response.rb +1 -1
  442. data/lib/repull/models/webhook_subscription.rb +1 -1
  443. data/lib/repull/version.rb +2 -2
  444. data/lib/repull.rb +153 -16
  445. data/openapi/v1.json +12620 -5281
  446. data/scripts/check-spec-freshness.py +399 -0
  447. data/scripts/regen.sh +32 -3
  448. metadata +155 -19
  449. data/lib/repull/api/sandbox_api.rb +0 -136
  450. data/lib/repull/models/sandbox_seed_result.rb +0 -278
  451. data/lib/repull/models/studio_generation.rb +0 -215
  452. data/lib/repull/models/studio_project.rb +0 -241
  453. data/spec/api/ai_api_spec.rb +0 -47
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -22,9 +22,18 @@ module Repull
22
22
  # Airbnb-side listing id
23
23
  attr_accessor :airbnb_id
24
24
 
25
- # Airbnb host user id
25
+ # Which connected Airbnb account this row belongs to — the Airbnb host id, as a string (they exceed 2^53). The same value `?account_id=` accepts and `GET /v1/connect/airbnb` returns as `accounts[].externalAccountId`.
26
+ attr_accessor :account_id
27
+
28
+ # Display name of that connected Airbnb account.
29
+ attr_accessor :account_name
30
+
31
+ # Alias of `accountId`, kept for compatibility — same Airbnb host id, same string.
26
32
  attr_accessor :host_id
27
33
 
34
+ # Alias of `accountName`, kept for compatibility.
35
+ attr_accessor :host_name
36
+
28
37
  attr_accessor :active
29
38
 
30
39
  attr_accessor :sync_enabled
@@ -34,12 +43,21 @@ module Repull
34
43
  # Decimal markup (e.g. \"1.10\" for +10%).
35
44
  attr_accessor :markup
36
45
 
46
+ # Airbnb's own API sync decision for THIS listing, as Airbnb reports it. Airbnb authorises sync one listing at a time, so a connected account can still contain listings it will not accept writes for. - `sync_all` — Repull manages content, rates and availability. - `sync_rates_and_availability` — Repull manages rates and availability; listing content is managed by the host on Airbnb. - `none` — the listing is **not** connected to Repull on Airbnb's side. Every write to it is refused with `403 listing_not_api_connected`; reconnecting the Airbnb account does not change this, the host must switch the listing on in Airbnb. `null` when the listing has not synced yet. Not to be confused with `syncEnabled`, which is a Repull-side flag and says nothing about what Airbnb accepts.
47
+ attr_accessor :sync_category
48
+
49
+ # Whether Repull will send a write for this listing to Airbnb. `false` exactly when `syncCategory` is `none` — such a write is refused with `403 listing_not_api_connected` before anything reaches Airbnb. Check this before a portfolio-wide push instead of discovering it one 403 at a time.
50
+ attr_accessor :writable
51
+
37
52
  attr_accessor :created_at
38
53
 
39
- # Present only when `?include=amenities` is passed. Sourced from the local `listings_airbnb_amenities` cache (populated by the Airbnb sync worker). Returns `null` when the cache is empty for this connection see the top-level `data_freshness` envelope to disambiguate \"never synced\" vs \"host disconnected\" vs \"fresh and genuinely empty\".
54
+ # Fields Airbnb will NOT let you change on this listing `property_type_category`, `name`, `check_in_option`, `summary`, `space`, individual amenities, … Airbnb does not refuse a write to a locked field: it returns 200, reports the field as locked, and applies nothing. Check this before a content write; `[]` means nothing is known to be locked. Recorded at sync time, so a lock added on Airbnb since the last sync will show up on the write instead (as `blockedFields` in the response).
55
+ attr_accessor :locked_fields
56
+
57
+ # Present only when `?include=amenities` is passed. Sourced from the local `listings_airbnb_amenities` cache (populated by the Airbnb sync worker). Returns `null` when the cache is empty for this connection — see the top-level `dataFreshness` envelope to disambiguate \"never synced\" vs \"host disconnected\" vs \"fresh and genuinely empty\".
40
58
  attr_accessor :amenities
41
59
 
42
- # Present only when `?include=amenities` is passed. Accessibility-tagged subset of the local amenity cache (step-free access, wide doorways, grab rails, disabled parking, wheelchair, accessible-height fixtures, hoists, etc). Returns an empty array when amenities synced but none qualify as accessibility; returns `null` when the cache is empty for this connection (use `data_freshness` to disambiguate \"never synced\" from \"fresh and genuinely empty\").
60
+ # Present only when `?include=amenities` is passed. Accessibility-tagged subset of the local amenity cache (step-free access, wide doorways, grab rails, disabled parking, wheelchair, accessible-height fixtures, hoists, etc). Returns an empty array when amenities synced but none qualify as accessibility; returns `null` when the cache is empty for this connection (use `dataFreshness` to disambiguate \"never synced\" from \"fresh and genuinely empty\").
43
61
  attr_accessor :accessibility_amenities
44
62
 
45
63
  # Attribute mapping from ruby-style variable name to JSON key.
@@ -47,12 +65,18 @@ module Repull
47
65
  {
48
66
  :'id' => :'id',
49
67
  :'airbnb_id' => :'airbnbId',
68
+ :'account_id' => :'accountId',
69
+ :'account_name' => :'accountName',
50
70
  :'host_id' => :'hostId',
71
+ :'host_name' => :'hostName',
51
72
  :'active' => :'active',
52
73
  :'sync_enabled' => :'syncEnabled',
53
74
  :'primary' => :'primary',
54
75
  :'markup' => :'markup',
76
+ :'sync_category' => :'syncCategory',
77
+ :'writable' => :'writable',
55
78
  :'created_at' => :'createdAt',
79
+ :'locked_fields' => :'lockedFields',
56
80
  :'amenities' => :'amenities',
57
81
  :'accessibility_amenities' => :'accessibility_amenities'
58
82
  }
@@ -71,14 +95,20 @@ module Repull
71
95
  # Attribute type mapping.
72
96
  def self.openapi_types
73
97
  {
74
- :'id' => :'Integer',
98
+ :'id' => :'String',
75
99
  :'airbnb_id' => :'String',
100
+ :'account_id' => :'String',
101
+ :'account_name' => :'String',
76
102
  :'host_id' => :'String',
103
+ :'host_name' => :'String',
77
104
  :'active' => :'Boolean',
78
105
  :'sync_enabled' => :'Boolean',
79
106
  :'primary' => :'Boolean',
80
107
  :'markup' => :'String',
108
+ :'sync_category' => :'String',
109
+ :'writable' => :'Boolean',
81
110
  :'created_at' => :'Time',
111
+ :'locked_fields' => :'Array<String>',
82
112
  :'amenities' => :'Array<AirbnbConnectionAmenitiesInner>',
83
113
  :'accessibility_amenities' => :'Array<AirbnbConnectionAccessibilityAmenitiesInner>'
84
114
  }
@@ -87,7 +117,12 @@ module Repull
87
117
  # List of attributes with nullable: true
88
118
  def self.openapi_nullable
89
119
  Set.new([
120
+ :'account_id',
121
+ :'account_name',
122
+ :'host_id',
123
+ :'host_name',
90
124
  :'markup',
125
+ :'sync_category',
91
126
  :'amenities',
92
127
  :'accessibility_amenities'
93
128
  ])
@@ -117,10 +152,22 @@ module Repull
117
152
  self.airbnb_id = attributes[:'airbnb_id']
118
153
  end
119
154
 
155
+ if attributes.key?(:'account_id')
156
+ self.account_id = attributes[:'account_id']
157
+ end
158
+
159
+ if attributes.key?(:'account_name')
160
+ self.account_name = attributes[:'account_name']
161
+ end
162
+
120
163
  if attributes.key?(:'host_id')
121
164
  self.host_id = attributes[:'host_id']
122
165
  end
123
166
 
167
+ if attributes.key?(:'host_name')
168
+ self.host_name = attributes[:'host_name']
169
+ end
170
+
124
171
  if attributes.key?(:'active')
125
172
  self.active = attributes[:'active']
126
173
  end
@@ -137,10 +184,24 @@ module Repull
137
184
  self.markup = attributes[:'markup']
138
185
  end
139
186
 
187
+ if attributes.key?(:'sync_category')
188
+ self.sync_category = attributes[:'sync_category']
189
+ end
190
+
191
+ if attributes.key?(:'writable')
192
+ self.writable = attributes[:'writable']
193
+ end
194
+
140
195
  if attributes.key?(:'created_at')
141
196
  self.created_at = attributes[:'created_at']
142
197
  end
143
198
 
199
+ if attributes.key?(:'locked_fields')
200
+ if (value = attributes[:'locked_fields']).is_a?(Array)
201
+ self.locked_fields = value
202
+ end
203
+ end
204
+
144
205
  if attributes.key?(:'amenities')
145
206
  if (value = attributes[:'amenities']).is_a?(Array)
146
207
  self.amenities = value
@@ -176,12 +237,18 @@ module Repull
176
237
  self.class == o.class &&
177
238
  id == o.id &&
178
239
  airbnb_id == o.airbnb_id &&
240
+ account_id == o.account_id &&
241
+ account_name == o.account_name &&
179
242
  host_id == o.host_id &&
243
+ host_name == o.host_name &&
180
244
  active == o.active &&
181
245
  sync_enabled == o.sync_enabled &&
182
246
  primary == o.primary &&
183
247
  markup == o.markup &&
248
+ sync_category == o.sync_category &&
249
+ writable == o.writable &&
184
250
  created_at == o.created_at &&
251
+ locked_fields == o.locked_fields &&
185
252
  amenities == o.amenities &&
186
253
  accessibility_amenities == o.accessibility_amenities
187
254
  end
@@ -195,7 +262,7 @@ module Repull
195
262
  # Calculates hash code according to all attributes.
196
263
  # @return [Integer] Hash code
197
264
  def hash
198
- [id, airbnb_id, host_id, active, sync_enabled, primary, markup, created_at, amenities, accessibility_amenities].hash
265
+ [id, airbnb_id, account_id, account_name, host_id, host_name, active, sync_enabled, primary, markup, sync_category, writable, created_at, locked_fields, amenities, accessibility_amenities].hash
199
266
  end
200
267
 
201
268
  # Builds the object from hash
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -24,7 +24,7 @@ module Repull
24
24
 
25
25
  attr_accessor :is_connected
26
26
 
27
- # When the host record was last touched (token refresh / activation / restriction). Closest available proxy for \"last successful sync\".
27
+ # When this account last COMPLETED an Airbnb import. `null` when it never has. A run that failed or was rate-limited does not move it, and neither does anything other than a sync.
28
28
  attr_accessor :last_synced_at
29
29
 
30
30
  # When the host was last marked inactive. Null on currently-connected hosts.
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -1,7 +1,7 @@
1
1
  =begin
2
2
  #Repull API
3
3
 
4
- #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_test_YOUR_API_KEY ``` Sandbox keys start with `sk_test_`, production with `sk_live_`. ## 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 `resets_at` 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`.
4
+ #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`.
5
5
 
6
6
  The version of the OpenAPI document: 1.0.0
7
7
  Contact: ivan@vanio.ai
@@ -0,0 +1,275 @@
1
+ =begin
2
+ #Repull API
3
+
4
+ #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`.
5
+
6
+ The version of the OpenAPI document: 1.0.0
7
+ Contact: ivan@vanio.ai
8
+ Generated by: https://openapi-generator.tech
9
+ Generator version: 7.22.0
10
+
11
+ =end
12
+
13
+ require 'date'
14
+ require 'time'
15
+
16
+ module Repull
17
+ # Result of a content write. **A 200 does not by itself mean the change was applied**: Airbnb locks host-managed fields on established listings and answers 200 while applying nothing for them. `blockedFields` is the list of fields YOU sent that Airbnb dropped; `blockedFields: []` is what a landed write looks like.
18
+ class AirbnbContentWriteResponse < ApiModelBase
19
+ attr_accessor :listing_id
20
+
21
+ # The Airbnb-side listing id the write went to.
22
+ attr_accessor :airbnb_listing_id
23
+
24
+ # Descriptions only — the locale written.
25
+ attr_accessor :locale
26
+
27
+ # Fields that were applied.
28
+ attr_accessor :written
29
+
30
+ # Fields you sent that Airbnb refused to change. Not retryable — the content is managed on Airbnb.
31
+ attr_accessor :blocked_fields
32
+
33
+ # Present only when `blockedFields` is non-empty: what was not applied.
34
+ attr_accessor :message
35
+
36
+ # Present only when `blockedFields` is non-empty: what to do about it.
37
+ attr_accessor :fix
38
+
39
+ # Airbnb's raw response.
40
+ attr_accessor :result
41
+
42
+ # Attribute mapping from ruby-style variable name to JSON key.
43
+ def self.attribute_map
44
+ {
45
+ :'listing_id' => :'listingId',
46
+ :'airbnb_listing_id' => :'airbnbListingId',
47
+ :'locale' => :'locale',
48
+ :'written' => :'written',
49
+ :'blocked_fields' => :'blockedFields',
50
+ :'message' => :'message',
51
+ :'fix' => :'fix',
52
+ :'result' => :'result'
53
+ }
54
+ end
55
+
56
+ # Returns attribute mapping this model knows about
57
+ def self.acceptable_attribute_map
58
+ attribute_map
59
+ end
60
+
61
+ # Returns all the JSON keys this model knows about
62
+ def self.acceptable_attributes
63
+ acceptable_attribute_map.values
64
+ end
65
+
66
+ # Attribute type mapping.
67
+ def self.openapi_types
68
+ {
69
+ :'listing_id' => :'String',
70
+ :'airbnb_listing_id' => :'String',
71
+ :'locale' => :'String',
72
+ :'written' => :'Array<String>',
73
+ :'blocked_fields' => :'Array<String>',
74
+ :'message' => :'String',
75
+ :'fix' => :'String',
76
+ :'result' => :'Hash<String, Object>'
77
+ }
78
+ end
79
+
80
+ # List of attributes with nullable: true
81
+ def self.openapi_nullable
82
+ Set.new([
83
+ ])
84
+ end
85
+
86
+ # Initializes the object
87
+ # @param [Hash] attributes Model attributes in the form of hash
88
+ def initialize(attributes = {})
89
+ if (!attributes.is_a?(Hash))
90
+ fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::AirbnbContentWriteResponse` initialize method"
91
+ end
92
+
93
+ # check to see if the attribute exists and convert string to symbol for hash key
94
+ acceptable_attribute_map = self.class.acceptable_attribute_map
95
+ attributes = attributes.each_with_object({}) { |(k, v), h|
96
+ if (!acceptable_attribute_map.key?(k.to_sym))
97
+ fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::AirbnbContentWriteResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
98
+ end
99
+ h[k.to_sym] = v
100
+ }
101
+
102
+ if attributes.key?(:'listing_id')
103
+ self.listing_id = attributes[:'listing_id']
104
+ else
105
+ self.listing_id = nil
106
+ end
107
+
108
+ if attributes.key?(:'airbnb_listing_id')
109
+ self.airbnb_listing_id = attributes[:'airbnb_listing_id']
110
+ end
111
+
112
+ if attributes.key?(:'locale')
113
+ self.locale = attributes[:'locale']
114
+ end
115
+
116
+ if attributes.key?(:'written')
117
+ if (value = attributes[:'written']).is_a?(Array)
118
+ self.written = value
119
+ end
120
+ else
121
+ self.written = nil
122
+ end
123
+
124
+ if attributes.key?(:'blocked_fields')
125
+ if (value = attributes[:'blocked_fields']).is_a?(Array)
126
+ self.blocked_fields = value
127
+ end
128
+ else
129
+ self.blocked_fields = nil
130
+ end
131
+
132
+ if attributes.key?(:'message')
133
+ self.message = attributes[:'message']
134
+ end
135
+
136
+ if attributes.key?(:'fix')
137
+ self.fix = attributes[:'fix']
138
+ end
139
+
140
+ if attributes.key?(:'result')
141
+ if (value = attributes[:'result']).is_a?(Hash)
142
+ self.result = value
143
+ end
144
+ end
145
+ end
146
+
147
+ # Show invalid properties with the reasons. Usually used together with valid?
148
+ # @return Array for valid properties with the reasons
149
+ def list_invalid_properties
150
+ warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
151
+ invalid_properties = Array.new
152
+ if @listing_id.nil?
153
+ invalid_properties.push('invalid value for "listing_id", listing_id cannot be nil.')
154
+ end
155
+
156
+ if @written.nil?
157
+ invalid_properties.push('invalid value for "written", written cannot be nil.')
158
+ end
159
+
160
+ if @blocked_fields.nil?
161
+ invalid_properties.push('invalid value for "blocked_fields", blocked_fields cannot be nil.')
162
+ end
163
+
164
+ invalid_properties
165
+ end
166
+
167
+ # Check to see if the all the properties in the model are valid
168
+ # @return true if the model is valid
169
+ def valid?
170
+ warn '[DEPRECATED] the `valid?` method is obsolete'
171
+ return false if @listing_id.nil?
172
+ return false if @written.nil?
173
+ return false if @blocked_fields.nil?
174
+ true
175
+ end
176
+
177
+ # Custom attribute writer method with validation
178
+ # @param [Object] listing_id Value to be assigned
179
+ def listing_id=(listing_id)
180
+ if listing_id.nil?
181
+ fail ArgumentError, 'listing_id cannot be nil'
182
+ end
183
+
184
+ @listing_id = listing_id
185
+ end
186
+
187
+ # Custom attribute writer method with validation
188
+ # @param [Object] written Value to be assigned
189
+ def written=(written)
190
+ if written.nil?
191
+ fail ArgumentError, 'written cannot be nil'
192
+ end
193
+
194
+ @written = written
195
+ end
196
+
197
+ # Custom attribute writer method with validation
198
+ # @param [Object] blocked_fields Value to be assigned
199
+ def blocked_fields=(blocked_fields)
200
+ if blocked_fields.nil?
201
+ fail ArgumentError, 'blocked_fields cannot be nil'
202
+ end
203
+
204
+ @blocked_fields = blocked_fields
205
+ end
206
+
207
+ # Checks equality by comparing each attribute.
208
+ # @param [Object] Object to be compared
209
+ def ==(o)
210
+ return true if self.equal?(o)
211
+ self.class == o.class &&
212
+ listing_id == o.listing_id &&
213
+ airbnb_listing_id == o.airbnb_listing_id &&
214
+ locale == o.locale &&
215
+ written == o.written &&
216
+ blocked_fields == o.blocked_fields &&
217
+ message == o.message &&
218
+ fix == o.fix &&
219
+ result == o.result
220
+ end
221
+
222
+ # @see the `==` method
223
+ # @param [Object] Object to be compared
224
+ def eql?(o)
225
+ self == o
226
+ end
227
+
228
+ # Calculates hash code according to all attributes.
229
+ # @return [Integer] Hash code
230
+ def hash
231
+ [listing_id, airbnb_listing_id, locale, written, blocked_fields, message, fix, result].hash
232
+ end
233
+
234
+ # Builds the object from hash
235
+ # @param [Hash] attributes Model attributes in the form of hash
236
+ # @return [Object] Returns the model itself
237
+ def self.build_from_hash(attributes)
238
+ return nil unless attributes.is_a?(Hash)
239
+ attributes = attributes.transform_keys(&:to_sym)
240
+ transformed_hash = {}
241
+ openapi_types.each_pair do |key, type|
242
+ if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
243
+ transformed_hash["#{key}"] = nil
244
+ elsif type =~ /\AArray<(.*)>/i
245
+ # check to ensure the input is an array given that the attribute
246
+ # is documented as an array but the input is not
247
+ if attributes[attribute_map[key]].is_a?(Array)
248
+ transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
249
+ end
250
+ elsif !attributes[attribute_map[key]].nil?
251
+ transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
252
+ end
253
+ end
254
+ new(transformed_hash)
255
+ end
256
+
257
+ # Returns the object in the form of hash
258
+ # @return [Hash] Returns the object in the form of hash
259
+ def to_hash
260
+ hash = {}
261
+ self.class.attribute_map.each_pair do |attr, param|
262
+ value = self.send(attr)
263
+ if value.nil?
264
+ is_nullable = self.class.openapi_nullable.include?(attr)
265
+ next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
266
+ end
267
+
268
+ hash[param] = _to_hash(value)
269
+ end
270
+ hash
271
+ end
272
+
273
+ end
274
+
275
+ end