repull 0.2.21 → 0.2.22

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 (592) hide show
  1. checksums.yaml +4 -4
  2. data/lib/repull/api/airbnb_api.rb +54 -15
  3. data/lib/repull/api/atlas_api.rb +1 -1
  4. data/lib/repull/api/availability_api.rb +3 -3
  5. data/lib/repull/api/billing_api.rb +1 -1
  6. data/lib/repull/api/booking_com_api.rb +5 -5
  7. data/lib/repull/api/connect_api.rb +137 -1
  8. data/lib/repull/api/conversations_api.rb +3 -3
  9. data/lib/repull/api/guests_api.rb +3 -3
  10. data/lib/repull/api/health_api.rb +1 -1
  11. data/lib/repull/api/kv_api.rb +1 -1
  12. data/lib/repull/api/listings_api.rb +70 -7
  13. data/lib/repull/api/markets_api.rb +1 -1
  14. data/lib/repull/api/migrate_api.rb +1 -1
  15. data/lib/repull/api/plumguide_api.rb +1 -1
  16. data/lib/repull/api/pricing_api.rb +1 -1
  17. data/lib/repull/api/properties_api.rb +1 -1
  18. data/lib/repull/api/quotes_api.rb +1 -1
  19. data/lib/repull/api/reservations_api.rb +71 -1
  20. data/lib/repull/api/reviews_api.rb +3 -3
  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 +1 -1
  24. data/lib/repull/api/webhooks_api.rb +1 -1
  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/accept_reservation_request200_response.rb +1 -1
  30. data/lib/repull/models/account_created_event.rb +1 -1
  31. data/lib/repull/models/account_created_payload.rb +1 -1
  32. data/lib/repull/models/account_disconnected_event.rb +1 -1
  33. data/lib/repull/models/account_disconnected_payload.rb +1 -1
  34. data/lib/repull/models/acknowledge_booking_reservations_request.rb +1 -1
  35. data/lib/repull/models/ai_operation.rb +1 -1
  36. data/lib/repull/models/ai_operation_completed_event.rb +1 -1
  37. data/lib/repull/models/ai_operation_completed_payload.rb +1 -1
  38. data/lib/repull/models/ai_operation_failed_event.rb +1 -1
  39. data/lib/repull/models/ai_operation_failed_payload.rb +1 -1
  40. data/lib/repull/models/ai_operation_failed_payload_error.rb +1 -1
  41. data/lib/repull/models/airbnb_account_freshness.rb +1 -1
  42. data/lib/repull/models/airbnb_alteration.rb +1 -1
  43. data/lib/repull/models/airbnb_alteration_create_request.rb +1 -1
  44. data/lib/repull/models/airbnb_amenity.rb +1 -1
  45. data/lib/repull/models/airbnb_availability_write_request.rb +1 -1
  46. data/lib/repull/models/airbnb_calendar_operation.rb +1 -1
  47. data/lib/repull/models/airbnb_connection.rb +2 -2
  48. data/lib/repull/models/airbnb_connection_accessibility_amenities_inner.rb +1 -1
  49. data/lib/repull/models/airbnb_connection_amenities_inner.rb +1 -1
  50. data/lib/repull/models/airbnb_connection_host.rb +1 -1
  51. data/lib/repull/models/airbnb_connection_response.rb +1 -1
  52. data/lib/repull/models/airbnb_connection_summary.rb +1 -1
  53. data/lib/repull/models/airbnb_content_write_response.rb +1 -1
  54. data/lib/repull/models/airbnb_data_freshness.rb +1 -1
  55. data/lib/repull/models/airbnb_description_write_request.rb +1 -1
  56. data/lib/repull/models/airbnb_description_write_request_description.rb +1 -1
  57. data/lib/repull/models/airbnb_listing.rb +4 -4
  58. data/lib/repull/models/airbnb_listing_action200_response.rb +1 -1
  59. data/lib/repull/models/airbnb_listing_action200_response_one_of.rb +1 -1
  60. data/lib/repull/models/airbnb_listing_action200_response_one_of1.rb +1 -1
  61. data/lib/repull/models/airbnb_listing_action_request.rb +1 -1
  62. data/lib/repull/models/airbnb_listing_details_response.rb +1 -1
  63. data/lib/repull/models/airbnb_listing_details_write_request.rb +1 -1
  64. data/lib/repull/models/airbnb_listing_details_write_request_check_in_option.rb +1 -1
  65. data/lib/repull/models/airbnb_listing_details_write_request_quiet_hours_inner.rb +1 -1
  66. data/lib/repull/models/airbnb_listing_lifecycle_response.rb +2 -2
  67. data/lib/repull/models/airbnb_listing_list_response.rb +1 -1
  68. data/lib/repull/models/airbnb_permits_response.rb +1 -1
  69. data/lib/repull/models/airbnb_permits_response_cached_inner.rb +1 -1
  70. data/lib/repull/models/airbnb_permits_write_request.rb +1 -1
  71. data/lib/repull/models/airbnb_permits_write_request_permits_inner.rb +1 -1
  72. data/lib/repull/models/airbnb_permits_write_request_permits_inner_answers_value.rb +1 -1
  73. data/lib/repull/models/airbnb_photo_position.rb +1 -1
  74. data/lib/repull/models/airbnb_pricing_write_request.rb +1 -1
  75. data/lib/repull/models/airbnb_pricing_write_request_records_inner.rb +1 -1
  76. data/lib/repull/models/airbnb_publish_result.rb +1 -1
  77. data/lib/repull/models/airbnb_reservation.rb +1 -1
  78. data/lib/repull/models/airbnb_reservation_action200_response.rb +1 -1
  79. data/lib/repull/models/airbnb_reservation_action_request.rb +1 -1
  80. data/lib/repull/models/airbnb_reservation_list_response.rb +1 -1
  81. data/lib/repull/models/airbnb_review.rb +1 -1
  82. data/lib/repull/models/airbnb_review_list_response.rb +1 -1
  83. data/lib/repull/models/airbnb_safety_disclosure.rb +1 -1
  84. data/lib/repull/models/airbnb_safety_disclosures_response.rb +1 -1
  85. data/lib/repull/models/airbnb_safety_disclosures_write_request.rb +1 -1
  86. data/lib/repull/models/airbnb_thread.rb +1 -1
  87. data/lib/repull/models/airbnb_thread_list_response.rb +1 -1
  88. data/lib/repull/models/airbnb_transaction.rb +216 -217
  89. data/lib/repull/models/airbnb_transaction_fees.rb +164 -0
  90. data/lib/repull/models/airbnb_transaction_payout.rb +47 -6
  91. data/lib/repull/models/alteration_change.rb +1 -1
  92. data/lib/repull/models/alteration_webhook_object.rb +1 -1
  93. data/lib/repull/models/availability_batch_write_request.rb +1 -1
  94. data/lib/repull/models/availability_write_request.rb +1 -1
  95. data/lib/repull/models/availability_write_result.rb +1 -1
  96. data/lib/repull/models/availability_write_result_synced.rb +1 -1
  97. data/lib/repull/models/availability_write_settings.rb +1 -1
  98. data/lib/repull/models/booking_availability_state_response.rb +1 -1
  99. data/lib/repull/models/booking_availability_update.rb +1 -1
  100. data/lib/repull/models/booking_availability_update_date_range.rb +1 -1
  101. data/lib/repull/models/booking_availability_update_request.rb +1 -1
  102. data/lib/repull/models/booking_availability_update_request_property_id.rb +1 -1
  103. data/lib/repull/models/booking_availability_update_request_updates_inner.rb +1 -1
  104. data/lib/repull/models/booking_connect_listing_option.rb +1 -1
  105. data/lib/repull/models/booking_connect_room.rb +1 -1
  106. data/lib/repull/models/booking_connect_rooms_response.rb +1 -1
  107. data/lib/repull/models/booking_conversation.rb +1 -1
  108. data/lib/repull/models/booking_pricing_rate_update.rb +1 -1
  109. data/lib/repull/models/booking_pricing_rate_update_date_range.rb +1 -1
  110. data/lib/repull/models/booking_pricing_rate_update_restrictions.rb +1 -1
  111. data/lib/repull/models/booking_pricing_response.rb +1 -1
  112. data/lib/repull/models/booking_pricing_update_request.rb +1 -1
  113. data/lib/repull/models/booking_pricing_update_response.rb +1 -1
  114. data/lib/repull/models/booking_property.rb +1 -1
  115. data/lib/repull/models/booking_property_action_request.rb +1 -1
  116. data/lib/repull/models/booking_property_action_response.rb +1 -1
  117. data/lib/repull/models/booking_property_listings_inner.rb +1 -1
  118. data/lib/repull/models/booking_publish_result.rb +1 -1
  119. data/lib/repull/models/booking_publish_section_error.rb +1 -1
  120. data/lib/repull/models/booking_rate_write_occupancy.rb +1 -1
  121. data/lib/repull/models/booking_rate_write_price_half.rb +1 -1
  122. data/lib/repull/models/booking_rate_write_restriction_half.rb +1 -1
  123. data/lib/repull/models/booking_rate_write_verification.rb +1 -1
  124. data/lib/repull/models/booking_rate_write_verification_row.rb +1 -1
  125. data/lib/repull/models/booking_reservation.rb +1 -1
  126. data/lib/repull/models/booking_reservation_room.rb +1 -1
  127. data/lib/repull/models/booking_restriction_request_row.rb +1 -1
  128. data/lib/repull/models/booking_restriction_verification.rb +1 -1
  129. data/lib/repull/models/booking_restriction_verification_row.rb +1 -1
  130. data/lib/repull/models/booking_restriction_verification_row_booking_value.rb +1 -1
  131. data/lib/repull/models/booking_restriction_verification_row_expected.rb +1 -1
  132. data/lib/repull/models/booking_room_mapping.rb +1 -1
  133. data/lib/repull/models/booking_rooms_rates_response.rb +1 -1
  134. data/lib/repull/models/booking_rooms_rates_response_rooms_inner.rb +1 -1
  135. data/lib/repull/models/booking_rooms_rates_response_rooms_inner_rates_inner.rb +1 -1
  136. data/lib/repull/models/booking_setup_request.rb +1 -1
  137. data/lib/repull/models/booking_setup_request_legal_entity.rb +1 -1
  138. data/lib/repull/models/booking_upstream_failure.rb +1 -1
  139. data/lib/repull/models/booking_verify_hotel_request.rb +1 -1
  140. data/lib/repull/models/booking_verify_hotel_response.rb +1 -1
  141. data/lib/repull/models/bulk_pricing_failure.rb +1 -1
  142. data/lib/repull/models/bulk_pricing_item.rb +1 -1
  143. data/lib/repull/models/bulk_pricing_request.rb +1 -1
  144. data/lib/repull/models/bulk_pricing_response.rb +1 -1
  145. data/lib/repull/models/calendar_day.rb +1 -1
  146. data/lib/repull/models/calendar_response.rb +1 -1
  147. data/lib/repull/models/calendar_updated_event.rb +1 -1
  148. data/lib/repull/models/calendar_updated_payload.rb +1 -1
  149. data/lib/repull/models/calendar_updated_payload_range.rb +1 -1
  150. data/lib/repull/models/cancel_reservation200_response.rb +259 -0
  151. data/lib/repull/models/{airbnb_transaction_guest_breakdown.rb → cancel_reservation200_response_pms.rb} +28 -29
  152. data/lib/repull/models/cancel_reservation200_response_pms_errors_inner.rb +165 -0
  153. data/lib/repull/models/cancel_reservation_request.rb +148 -0
  154. data/lib/repull/models/channel_market_state_item.rb +2 -2
  155. data/lib/repull/models/check_migration_cutover200_response.rb +1 -1
  156. data/lib/repull/models/check_migration_cutover_request.rb +1 -1
  157. data/lib/repull/models/check_migration_cutover_request_reservations_inner.rb +1 -1
  158. data/lib/repull/models/clear_kv200_response.rb +1 -1
  159. data/lib/repull/models/connect_host.rb +1 -1
  160. data/lib/repull/models/connect_provider.rb +1 -1
  161. data/lib/repull/models/connect_provider_list_response.rb +1 -1
  162. data/lib/repull/models/connect_session.rb +1 -1
  163. data/lib/repull/models/connect_status.rb +1 -1
  164. data/lib/repull/models/connect_status_accounts_inner.rb +1 -1
  165. data/lib/repull/models/connection.rb +1 -1
  166. data/lib/repull/models/connection_list_response.rb +11 -2
  167. data/lib/repull/models/conversation.rb +1 -1
  168. data/lib/repull/models/conversation_detail.rb +1 -1
  169. data/lib/repull/models/conversation_guest.rb +1 -1
  170. data/lib/repull/models/conversation_guest_contact.rb +1 -1
  171. data/lib/repull/models/conversation_host.rb +1 -1
  172. data/lib/repull/models/conversation_list_response.rb +1 -1
  173. data/lib/repull/models/conversation_message_attachment.rb +1 -1
  174. data/lib/repull/models/create_airbnb_listing_room_request.rb +1 -1
  175. data/lib/repull/models/create_airbnb_offer_request.rb +1 -1
  176. data/lib/repull/models/create_airbnb_offer_request_guest_details.rb +1 -1
  177. data/lib/repull/models/create_billing_checkout_request.rb +1 -1
  178. data/lib/repull/models/create_booking_webhook_request.rb +1 -1
  179. data/lib/repull/models/create_connect_session_request.rb +1 -1
  180. data/lib/repull/models/create_connect_session_request_copy.rb +1 -1
  181. data/lib/repull/models/create_connect_session_request_workspace.rb +1 -1
  182. data/lib/repull/models/create_connection_request.rb +1 -1
  183. data/lib/repull/models/create_conversation_special_offer201_response.rb +1 -1
  184. data/lib/repull/models/create_conversation_special_offer201_response_guests.rb +1 -1
  185. data/lib/repull/models/create_conversation_special_offer_request.rb +1 -1
  186. data/lib/repull/models/create_conversation_special_offer_request_guests.rb +1 -1
  187. data/lib/repull/models/create_webhook_request.rb +1 -1
  188. data/lib/repull/models/custom_schema.rb +1 -1
  189. data/lib/repull/models/custom_schema_create.rb +1 -1
  190. data/lib/repull/models/custom_schema_create_response.rb +1 -1
  191. data/lib/repull/models/custom_schema_delete_response.rb +1 -1
  192. data/lib/repull/models/custom_schema_list_response.rb +1 -1
  193. data/lib/repull/models/custom_schema_summary.rb +1 -1
  194. data/lib/repull/models/custom_schema_update.rb +1 -1
  195. data/lib/repull/models/decline_reservation_request_request.rb +1 -1
  196. data/lib/repull/models/delete_airbnb_listing_photo200_response.rb +1 -1
  197. data/lib/repull/models/delete_airbnb_listing_room200_response.rb +1 -1
  198. data/lib/repull/models/delete_connection200_response.rb +1 -1
  199. data/lib/repull/models/delete_kv200_response.rb +1 -1
  200. data/lib/repull/models/delete_migration200_response.rb +1 -1
  201. data/lib/repull/models/delete_migration200_response_data.rb +1 -1
  202. data/lib/repull/models/error.rb +1 -1
  203. data/lib/repull/models/error_error.rb +1 -1
  204. data/lib/repull/models/error_error_support.rb +1 -1
  205. data/lib/repull/models/get_airbnb_alteration200_response.rb +1 -1
  206. data/lib/repull/models/get_airbnb_booking_settings200_response.rb +1 -1
  207. data/lib/repull/models/get_airbnb_booking_settings200_response_data.rb +1 -1
  208. data/lib/repull/models/get_airbnb_booking_settings200_response_data_advance_notice.rb +1 -1
  209. data/lib/repull/models/get_airbnb_booking_settings200_response_data_booking_window.rb +1 -1
  210. data/lib/repull/models/get_airbnb_booking_settings200_response_data_cancellation.rb +1 -1
  211. data/lib/repull/models/get_airbnb_booking_settings200_response_data_cancellation_non_refundable.rb +1 -1
  212. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_in.rb +1 -1
  213. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_in_start.rb +1 -1
  214. data/lib/repull/models/get_airbnb_booking_settings200_response_data_check_out.rb +1 -1
  215. data/lib/repull/models/get_airbnb_booking_settings200_response_data_instant_book.rb +1 -1
  216. data/lib/repull/models/get_airbnb_booking_settings200_response_data_preparation_time.rb +1 -1
  217. data/lib/repull/models/get_airbnb_checkin_guide200_response.rb +1 -1
  218. data/lib/repull/models/get_airbnb_listing_details200_response.rb +1 -1
  219. data/lib/repull/models/get_airbnb_listing_quality200_response.rb +1 -1
  220. data/lib/repull/models/get_airbnb_listing_settings200_response.rb +1 -1
  221. data/lib/repull/models/get_airbnb_offer200_response.rb +1 -1
  222. data/lib/repull/models/get_airbnb_thread200_response.rb +1 -1
  223. data/lib/repull/models/get_health200_response.rb +1 -1
  224. data/lib/repull/models/get_listing_markups200_response.rb +1 -1
  225. data/lib/repull/models/get_listing_markups200_response_airbnb_inner.rb +1 -1
  226. data/lib/repull/models/get_listing_markups200_response_booking_inner.rb +1 -1
  227. data/lib/repull/models/get_migration200_response.rb +1 -1
  228. data/lib/repull/models/get_migration_channel_map200_response.rb +1 -1
  229. data/lib/repull/models/get_migration_report200_response.rb +1 -1
  230. data/lib/repull/models/get_usage_logs200_response.rb +1 -1
  231. data/lib/repull/models/get_usage_logs200_response_data_inner.rb +1 -1
  232. data/lib/repull/models/get_usage_logs200_response_pagination.rb +1 -1
  233. data/lib/repull/models/get_usage_summary200_response.rb +14 -5
  234. data/lib/repull/models/get_usage_summary200_response_breakdown_inner.rb +1 -1
  235. data/lib/repull/models/get_usage_summary200_response_limits.rb +1 -1
  236. data/lib/repull/models/get_usage_summary200_response_remaining.rb +1 -1
  237. data/lib/repull/models/get_usage_summary200_response_status_distribution.rb +1 -1
  238. data/lib/repull/models/get_usage_summary200_response_timeline_inner.rb +1 -1
  239. data/lib/repull/models/get_usage_summary200_response_totals.rb +1 -1
  240. data/lib/repull/models/get_usage_summary200_response_used.rb +1 -1
  241. data/lib/repull/models/get_usage_tier200_response.rb +1 -1
  242. data/lib/repull/models/get_usage_tier200_response_limits.rb +1 -1
  243. data/lib/repull/models/get_usage_tier200_response_remaining.rb +1 -1
  244. data/lib/repull/models/get_usage_tier200_response_used.rb +1 -1
  245. data/lib/repull/models/guest.rb +1 -1
  246. data/lib/repull/models/guest_contact.rb +1 -1
  247. data/lib/repull/models/guest_create_request.rb +1 -1
  248. data/lib/repull/models/guest_create_response.rb +1 -1
  249. data/lib/repull/models/guest_create_response_contacts_inner.rb +1 -1
  250. data/lib/repull/models/guest_flag.rb +2 -2
  251. data/lib/repull/models/guest_list_response.rb +1 -1
  252. data/lib/repull/models/guest_note.rb +1 -1
  253. data/lib/repull/models/guest_profile.rb +2 -2
  254. data/lib/repull/models/guest_reservations_summary.rb +1 -1
  255. data/lib/repull/models/inquiry_created_event.rb +1 -1
  256. data/lib/repull/models/inquiry_created_payload.rb +1 -1
  257. data/lib/repull/models/inquiry_updated_event.rb +1 -1
  258. data/lib/repull/models/inquiry_updated_payload.rb +1 -1
  259. data/lib/repull/models/inquiry_webhook_object.rb +1 -1
  260. data/lib/repull/models/inquiry_webhook_object_expected_payout.rb +1 -1
  261. data/lib/repull/models/inquiry_webhook_object_guests.rb +1 -1
  262. data/lib/repull/models/list_airbnb_alterations200_response.rb +1 -1
  263. data/lib/repull/models/list_airbnb_listing_amenities200_response.rb +1 -1
  264. data/lib/repull/models/list_airbnb_listing_amenities200_response_data.rb +1 -1
  265. data/lib/repull/models/list_airbnb_listing_permits200_response.rb +1 -1
  266. data/lib/repull/models/list_airbnb_listing_safety_disclosures200_response.rb +1 -1
  267. data/lib/repull/models/list_airbnb_thread_messages200_response.rb +1 -1
  268. data/lib/repull/models/list_airbnb_thread_messages200_response_data_inner.rb +1 -1
  269. data/lib/repull/models/list_airbnb_thread_messages200_response_pagination.rb +1 -1
  270. data/lib/repull/models/list_airbnb_transactions200_response.rb +28 -2
  271. data/lib/repull/models/list_booking_reservations200_response.rb +1 -1
  272. data/lib/repull/models/list_inquiries200_response.rb +1 -1
  273. data/lib/repull/models/list_inquiries200_response_data_inner.rb +1 -1
  274. data/lib/repull/models/list_inquiries200_response_data_inner_expected_payout.rb +1 -1
  275. data/lib/repull/models/list_inquiries200_response_data_inner_guests.rb +1 -1
  276. data/lib/repull/models/list_kv200_response.rb +1 -1
  277. data/lib/repull/models/list_kv200_response_data_inner.rb +1 -1
  278. data/lib/repull/models/list_kv200_response_pagination.rb +1 -1
  279. data/lib/repull/models/list_listing_units200_response.rb +167 -0
  280. data/lib/repull/models/list_listing_units200_response_data_inner.rb +207 -0
  281. data/lib/repull/models/list_migrations200_response.rb +1 -1
  282. data/lib/repull/models/listing.rb +14 -2
  283. data/lib/repull/models/listing_active_request.rb +1 -1
  284. data/lib/repull/models/listing_active_response.rb +1 -1
  285. data/lib/repull/models/listing_address.rb +1 -1
  286. data/lib/repull/models/listing_address_readiness.rb +1 -1
  287. data/lib/repull/models/listing_amenity.rb +1 -1
  288. data/lib/repull/models/listing_channel.rb +1 -1
  289. data/lib/repull/models/listing_comp.rb +1 -1
  290. data/lib/repull/models/listing_comp_nightly.rb +1 -1
  291. data/lib/repull/models/listing_comp_ratings.rb +1 -1
  292. data/lib/repull/models/listing_comps_response.rb +1 -1
  293. data/lib/repull/models/listing_content.rb +1 -1
  294. data/lib/repull/models/listing_content_update_request.rb +1 -1
  295. data/lib/repull/models/listing_content_update_request_address.rb +1 -1
  296. data/lib/repull/models/listing_content_update_request_amenities.rb +1 -1
  297. data/lib/repull/models/listing_content_update_request_amenities_one_of_inner.rb +1 -1
  298. data/lib/repull/models/listing_content_update_request_checkout_tasks_inner.rb +1 -1
  299. data/lib/repull/models/listing_content_update_request_details.rb +1 -1
  300. data/lib/repull/models/listing_content_update_request_occupancy.rb +1 -1
  301. data/lib/repull/models/listing_content_update_request_photos_inner.rb +1 -1
  302. data/lib/repull/models/listing_content_update_request_photos_inner_one_of.rb +1 -1
  303. data/lib/repull/models/listing_content_update_request_policies.rb +1 -1
  304. data/lib/repull/models/listing_content_update_request_pricing.rb +1 -1
  305. data/lib/repull/models/listing_content_update_request_rooms_inner.rb +1 -1
  306. data/lib/repull/models/listing_content_update_request_rooms_inner_beds_inner.rb +1 -1
  307. data/lib/repull/models/listing_content_update_response.rb +1 -1
  308. data/lib/repull/models/listing_create_request.rb +1 -1
  309. data/lib/repull/models/listing_create_response.rb +1 -1
  310. data/lib/repull/models/listing_created_event.rb +1 -1
  311. data/lib/repull/models/listing_created_payload.rb +1 -1
  312. data/lib/repull/models/listing_created_payload_address.rb +1 -1
  313. data/lib/repull/models/listing_deleted_event.rb +1 -1
  314. data/lib/repull/models/listing_deleted_payload.rb +1 -1
  315. data/lib/repull/models/listing_details.rb +1 -1
  316. data/lib/repull/models/listing_generate_content_request.rb +1 -1
  317. data/lib/repull/models/listing_generate_content_response.rb +1 -1
  318. data/lib/repull/models/listing_list_response.rb +11 -2
  319. data/lib/repull/models/listing_market_state_request.rb +1 -1
  320. data/lib/repull/models/listing_market_state_response.rb +1 -1
  321. data/lib/repull/models/listing_photo.rb +1 -1
  322. data/lib/repull/models/listing_photo_delete_request.rb +1 -1
  323. data/lib/repull/models/listing_photo_delete_response.rb +1 -1
  324. data/lib/repull/models/listing_photo_upload_url_request.rb +19 -3
  325. data/lib/repull/models/listing_photo_upload_url_response.rb +16 -6
  326. data/lib/repull/models/listing_photos_response.rb +1 -1
  327. data/lib/repull/models/listing_pricing_apply_request.rb +1 -1
  328. data/lib/repull/models/listing_pricing_apply_response.rb +1 -1
  329. data/lib/repull/models/listing_pricing_history_entry.rb +1 -1
  330. data/lib/repull/models/listing_pricing_history_response.rb +1 -1
  331. data/lib/repull/models/listing_pricing_recommendation.rb +2 -2
  332. data/lib/repull/models/listing_pricing_response.rb +1 -1
  333. data/lib/repull/models/listing_pricing_response_comp_summary.rb +1 -1
  334. data/lib/repull/models/listing_pricing_response_date_range.rb +1 -1
  335. data/lib/repull/models/listing_pricing_response_listing.rb +1 -1
  336. data/lib/repull/models/listing_pricing_strategy.rb +1 -1
  337. data/lib/repull/models/listing_pricing_strategy_input.rb +1 -1
  338. data/lib/repull/models/listing_publish_airbnb_request.rb +1 -1
  339. data/lib/repull/models/listing_publish_airbnb_response.rb +1 -1
  340. data/lib/repull/models/listing_publish_booking_request.rb +1 -1
  341. data/lib/repull/models/listing_publish_booking_response.rb +1 -1
  342. data/lib/repull/models/listing_publish_status_channel.rb +1 -1
  343. data/lib/repull/models/listing_publish_status_connection.rb +1 -1
  344. data/lib/repull/models/listing_publish_status_response.rb +1 -1
  345. data/lib/repull/models/listing_pull_airbnb_request.rb +1 -1
  346. data/lib/repull/models/listing_pull_response.rb +1 -1
  347. data/lib/repull/models/listing_quality_tier.rb +1 -1
  348. data/lib/repull/models/listing_reactivated_event.rb +1 -1
  349. data/lib/repull/models/listing_segment.rb +1 -1
  350. data/lib/repull/models/listing_segment_recommendation.rb +1 -1
  351. data/lib/repull/models/listing_segments_response.rb +1 -1
  352. data/lib/repull/models/listing_segments_response_scope.rb +1 -1
  353. data/lib/repull/models/listing_status_batch_request.rb +1 -1
  354. data/lib/repull/models/listing_status_batch_response.rb +1 -1
  355. data/lib/repull/models/listing_suspended_event.rb +1 -1
  356. data/lib/repull/models/listing_suspension_payload.rb +1 -1
  357. data/lib/repull/models/listing_units_inner.rb +204 -0
  358. data/lib/repull/models/listing_updated_event.rb +1 -1
  359. data/lib/repull/models/listing_updated_payload.rb +1 -1
  360. data/lib/repull/models/listing_webhook_object.rb +1 -1
  361. data/lib/repull/models/listing_webhook_object_address.rb +1 -1
  362. data/lib/repull/models/listing_webhook_object_channels_inner.rb +1 -1
  363. data/lib/repull/models/map_airbnb_listing_request.rb +1 -1
  364. data/lib/repull/models/map_airbnb_listing_response.rb +1 -1
  365. data/lib/repull/models/map_booking_room_request.rb +1 -1
  366. data/lib/repull/models/map_booking_room_response.rb +17 -6
  367. data/lib/repull/models/map_connect_booking_rooms_request.rb +1 -1
  368. data/lib/repull/models/map_connect_booking_rooms_response.rb +29 -8
  369. data/lib/repull/models/market_browse_category.rb +1 -1
  370. data/lib/repull/models/market_browse_entry.rb +1 -1
  371. data/lib/repull/models/market_browse_featured.rb +1 -1
  372. data/lib/repull/models/market_browse_response.rb +1 -1
  373. data/lib/repull/models/market_calendar_day.rb +1 -1
  374. data/lib/repull/models/market_calendar_day_events_inner.rb +1 -1
  375. data/lib/repull/models/market_calendar_response.rb +1 -1
  376. data/lib/repull/models/market_detail_response.rb +1 -1
  377. data/lib/repull/models/market_detail_response_price_distribution_inner.rb +1 -1
  378. data/lib/repull/models/market_detail_response_property_type_mix_inner.rb +1 -1
  379. data/lib/repull/models/market_detail_response_supply_trend_inner.rb +1 -1
  380. data/lib/repull/models/market_detail_response_top_comps.rb +1 -1
  381. data/lib/repull/models/market_event.rb +1 -1
  382. data/lib/repull/models/market_my_listing.rb +1 -1
  383. data/lib/repull/models/market_summary.rb +1 -1
  384. data/lib/repull/models/market_top_comp.rb +1 -1
  385. data/lib/repull/models/markets_overview_response.rb +1 -1
  386. data/lib/repull/models/markets_overview_response_browse.rb +1 -1
  387. data/lib/repull/models/markets_overview_response_subscriptions.rb +1 -1
  388. data/lib/repull/models/markets_overview_response_totals.rb +1 -1
  389. data/lib/repull/models/message.rb +3 -3
  390. data/lib/repull/models/message_list_response.rb +1 -1
  391. data/lib/repull/models/migration.rb +1 -1
  392. data/lib/repull/models/migration_channel_map.rb +1 -1
  393. data/lib/repull/models/migration_channel_map_listings_inner.rb +1 -1
  394. data/lib/repull/models/migration_channel_map_listings_inner_airbnb.rb +1 -1
  395. data/lib/repull/models/migration_channel_map_listings_inner_booking.rb +1 -1
  396. data/lib/repull/models/migration_channel_map_sources_inner.rb +1 -1
  397. data/lib/repull/models/migration_completed_event.rb +1 -1
  398. data/lib/repull/models/migration_connections_inner.rb +1 -1
  399. data/lib/repull/models/migration_counts.rb +1 -1
  400. data/lib/repull/models/migration_cutover_check.rb +1 -1
  401. data/lib/repull/models/migration_cutover_check_mismatched_inner.rb +1 -1
  402. data/lib/repull/models/migration_failed_event.rb +1 -1
  403. data/lib/repull/models/migration_import_payload.rb +1 -1
  404. data/lib/repull/models/migration_import_payload_results_inner.rb +1 -1
  405. data/lib/repull/models/migration_import_run.rb +1 -1
  406. data/lib/repull/models/migration_import_run_results_inner.rb +1 -1
  407. data/lib/repull/models/migration_report.rb +1 -1
  408. data/lib/repull/models/migration_report_issues_inner.rb +1 -1
  409. data/lib/repull/models/migration_reservation_ref.rb +1 -1
  410. data/lib/repull/models/pagination.rb +1 -1
  411. data/lib/repull/models/payment_completed_event.rb +1 -1
  412. data/lib/repull/models/payment_completed_payload.rb +1 -1
  413. data/lib/repull/models/payment_refunded_event.rb +1 -1
  414. data/lib/repull/models/payment_refunded_payload.rb +1 -1
  415. data/lib/repull/models/payment_webhook_object.rb +1 -1
  416. data/lib/repull/models/payout_completed_event.rb +281 -0
  417. data/lib/repull/models/payout_completed_payload.rb +257 -0
  418. data/lib/repull/models/plan_notice.rb +283 -0
  419. data/lib/repull/models/plumguide_listing.rb +1 -1
  420. data/lib/repull/models/plumguide_listing_list_response.rb +1 -1
  421. data/lib/repull/models/preapprove_conversation201_response.rb +1 -1
  422. data/lib/repull/models/preapprove_conversation_request.rb +1 -1
  423. data/lib/repull/models/property.rb +1 -1
  424. data/lib/repull/models/property_availability.rb +1 -1
  425. data/lib/repull/models/property_availability_coverage.rb +1 -1
  426. data/lib/repull/models/property_availability_day.rb +41 -5
  427. data/lib/repull/models/property_list_response.rb +11 -2
  428. data/lib/repull/models/publish_section_error.rb +1 -1
  429. data/lib/repull/models/quote.rb +1 -1
  430. data/lib/repull/models/quote_pricing.rb +1 -1
  431. data/lib/repull/models/reorder_airbnb_listing_photos200_response.rb +1 -1
  432. data/lib/repull/models/reorder_airbnb_listing_photos200_response_data.rb +1 -1
  433. data/lib/repull/models/reorder_airbnb_listing_photos_request.rb +1 -1
  434. data/lib/repull/models/replay_webhook_delivery_request.rb +1 -1
  435. data/lib/repull/models/reply_booking_review200_response.rb +1 -1
  436. data/lib/repull/models/reply_booking_review_request.rb +1 -1
  437. data/lib/repull/models/reply_to_review201_response.rb +1 -1
  438. data/lib/repull/models/reply_to_review_request.rb +1 -1
  439. data/lib/repull/models/repull_ping_event.rb +1 -1
  440. data/lib/repull/models/repull_ping_payload.rb +1 -1
  441. data/lib/repull/models/reservation.rb +12 -2
  442. data/lib/repull/models/reservation_alteration_created_event.rb +1 -1
  443. data/lib/repull/models/reservation_alteration_created_payload.rb +1 -1
  444. data/lib/repull/models/reservation_alteration_responded_event.rb +1 -1
  445. data/lib/repull/models/reservation_alteration_responded_payload.rb +1 -1
  446. data/lib/repull/models/reservation_cancelled_event.rb +1 -1
  447. data/lib/repull/models/reservation_cancelled_payload.rb +1 -1
  448. data/lib/repull/models/reservation_create_request.rb +1 -1
  449. data/lib/repull/models/reservation_create_response.rb +27 -7
  450. data/lib/repull/models/reservation_create_response_pms.rb +180 -0
  451. data/lib/repull/models/reservation_create_response_unit.rb +158 -0
  452. data/lib/repull/models/reservation_created_event.rb +1 -1
  453. data/lib/repull/models/reservation_created_payload.rb +1 -1
  454. data/lib/repull/models/reservation_financials.rb +1 -1
  455. data/lib/repull/models/reservation_guest_financials.rb +1 -1
  456. data/lib/repull/models/reservation_guest_input.rb +1 -1
  457. data/lib/repull/models/reservation_host_financials.rb +1 -1
  458. data/lib/repull/models/reservation_list_response.rb +1 -1
  459. data/lib/repull/models/reservation_message_received_event.rb +1 -1
  460. data/lib/repull/models/reservation_message_received_payload.rb +1 -1
  461. data/lib/repull/models/reservation_message_received_payload_from.rb +1 -1
  462. data/lib/repull/models/reservation_message_sent_event.rb +281 -0
  463. data/lib/repull/models/reservation_message_sent_payload.rb +263 -0
  464. data/lib/repull/models/reservation_message_sent_payload_from.rb +158 -0
  465. data/lib/repull/models/{airbnb_transaction_host_breakdown.rb → reservation_message_updated_event.rb} +128 -93
  466. data/lib/repull/models/reservation_message_updated_payload.rb +244 -0
  467. data/lib/repull/models/reservation_message_updated_payload_from.rb +157 -0
  468. data/lib/repull/models/reservation_money_line.rb +1 -1
  469. data/lib/repull/models/reservation_occupancy.rb +1 -1
  470. data/lib/repull/models/reservation_primary_guest.rb +1 -1
  471. data/lib/repull/models/reservation_request_created_event.rb +1 -1
  472. data/lib/repull/models/reservation_request_created_payload.rb +1 -1
  473. data/lib/repull/models/reservation_request_updated_event.rb +1 -1
  474. data/lib/repull/models/reservation_request_updated_payload.rb +1 -1
  475. data/lib/repull/models/reservation_unit.rb +159 -0
  476. data/lib/repull/models/reservation_update_request.rb +1 -1
  477. data/lib/repull/models/reservation_update_response.rb +1 -1
  478. data/lib/repull/models/reservation_updated_event.rb +1 -1
  479. data/lib/repull/models/reservation_updated_payload.rb +1 -1
  480. data/lib/repull/models/reservation_webhook_object.rb +1 -1
  481. data/lib/repull/models/respond_airbnb_review_request.rb +1 -1
  482. data/lib/repull/models/review.rb +2 -2
  483. data/lib/repull/models/review_category.rb +1 -1
  484. data/lib/repull/models/review_created_event.rb +1 -1
  485. data/lib/repull/models/review_created_payload.rb +1 -1
  486. data/lib/repull/models/review_list_response.rb +1 -1
  487. data/lib/repull/models/review_responded_event.rb +1 -1
  488. data/lib/repull/models/review_responded_payload.rb +1 -1
  489. data/lib/repull/models/review_response.rb +1 -1
  490. data/lib/repull/models/review_webhook_object.rb +1 -1
  491. data/lib/repull/models/rotate_webhook_secret200_response.rb +1 -1
  492. data/lib/repull/models/run_migration_import202_response.rb +1 -1
  493. data/lib/repull/models/run_migration_import202_response_data.rb +1 -1
  494. data/lib/repull/models/run_migration_import202_response_data_queued_inner.rb +1 -1
  495. data/lib/repull/models/run_migration_import_request.rb +1 -1
  496. data/lib/repull/models/select_connect_provider_request.rb +1 -1
  497. data/lib/repull/models/select_provider_response.rb +1 -1
  498. data/lib/repull/models/send_airbnb_message201_response.rb +1 -1
  499. data/lib/repull/models/send_airbnb_message_request.rb +1 -1
  500. data/lib/repull/models/send_booking_message_request.rb +1 -1
  501. data/lib/repull/models/send_message_attachment.rb +1 -1
  502. data/lib/repull/models/send_message_part.rb +1 -1
  503. data/lib/repull/models/send_message_request.rb +1 -1
  504. data/lib/repull/models/send_message_response.rb +1 -1
  505. data/lib/repull/models/sent_attachment.rb +1 -1
  506. data/lib/repull/models/set_airbnb_listing_cover_photo200_response.rb +1 -1
  507. data/lib/repull/models/set_airbnb_listing_cover_photo200_response_data.rb +1 -1
  508. data/lib/repull/models/set_airbnb_listing_cover_photo_request.rb +1 -1
  509. data/lib/repull/models/set_kv_request.rb +1 -1
  510. data/lib/repull/models/set_listing_markup_request.rb +1 -1
  511. data/lib/repull/models/submit_beds24_credentials200_response.rb +1 -1
  512. data/lib/repull/models/submit_beds24_credentials_request.rb +1 -1
  513. data/lib/repull/models/submit_bookingsync_credentials_request.rb +1 -1
  514. data/lib/repull/models/submit_cloudbeds_credentials200_response.rb +204 -0
  515. data/lib/repull/models/submit_cloudbeds_credentials200_response_account_info.rb +170 -0
  516. data/lib/repull/models/submit_cloudbeds_credentials200_response_webhooks.rb +158 -0
  517. data/lib/repull/models/submit_cloudbeds_credentials_request.rb +174 -0
  518. data/lib/repull/models/submit_cloudbeds_credentials_request_credentials.rb +178 -0
  519. data/lib/repull/models/submit_guesty_credentials_request.rb +1 -1
  520. data/lib/repull/models/submit_hospitable_credentials_request.rb +1 -1
  521. data/lib/repull/models/submit_hostaway_credentials_request.rb +1 -1
  522. data/lib/repull/models/submit_igms_credentials_request.rb +1 -1
  523. data/lib/repull/models/submit_lodgify_credentials_request.rb +1 -1
  524. data/lib/repull/models/submit_mews_credentials200_response.rb +204 -0
  525. data/lib/repull/models/submit_mews_credentials200_response_account_info.rb +170 -0
  526. data/lib/repull/models/submit_mews_credentials_request.rb +174 -0
  527. data/lib/repull/models/submit_mews_credentials_request_credentials.rb +212 -0
  528. data/lib/repull/models/submit_ownerrez_credentials_request.rb +1 -1
  529. data/lib/repull/models/submit_smoobu_credentials_request.rb +1 -1
  530. data/lib/repull/models/submit_vrbo_credentials_request.rb +1 -1
  531. data/lib/repull/models/sync_airbnb_transactions200_response.rb +34 -6
  532. data/lib/repull/models/sync_airbnb_transactions200_response_accounts_inner.rb +254 -0
  533. data/lib/repull/models/sync_airbnb_transactions200_response_accounts_inner_error.rb +191 -0
  534. data/lib/repull/models/sync_airbnb_transactions_request.rb +4 -3
  535. data/lib/repull/models/test_webhook_request.rb +1 -1
  536. data/lib/repull/models/update_airbnb_booking_settings200_response.rb +1 -1
  537. data/lib/repull/models/update_airbnb_booking_settings200_response_data.rb +1 -1
  538. data/lib/repull/models/update_airbnb_booking_settings_request.rb +1 -1
  539. data/lib/repull/models/update_airbnb_booking_settings_request_advance_notice.rb +1 -1
  540. data/lib/repull/models/update_airbnb_booking_settings_request_booking_window.rb +1 -1
  541. data/lib/repull/models/update_airbnb_booking_settings_request_cancellation.rb +1 -1
  542. data/lib/repull/models/update_airbnb_booking_settings_request_cancellation_non_refundable.rb +1 -1
  543. data/lib/repull/models/update_airbnb_booking_settings_request_check_in.rb +1 -1
  544. data/lib/repull/models/update_airbnb_booking_settings_request_check_out.rb +1 -1
  545. data/lib/repull/models/update_airbnb_booking_settings_request_instant_book.rb +1 -1
  546. data/lib/repull/models/update_airbnb_booking_settings_request_preparation_time.rb +1 -1
  547. data/lib/repull/models/update_airbnb_listing_amenities200_response.rb +1 -1
  548. data/lib/repull/models/update_airbnb_listing_amenities200_response_data.rb +1 -1
  549. data/lib/repull/models/update_airbnb_listing_amenities_request.rb +1 -1
  550. data/lib/repull/models/update_airbnb_listing_amenities_request_accessibility_amenities_inner.rb +1 -1
  551. data/lib/repull/models/update_airbnb_listing_amenities_request_amenities_inner.rb +1 -1
  552. data/lib/repull/models/update_airbnb_listing_permits200_response.rb +1 -1
  553. data/lib/repull/models/update_airbnb_listing_photo200_response.rb +1 -1
  554. data/lib/repull/models/update_airbnb_listing_photo_request.rb +1 -1
  555. data/lib/repull/models/update_airbnb_listing_room200_response.rb +1 -1
  556. data/lib/repull/models/update_airbnb_listing_room_request.rb +1 -1
  557. data/lib/repull/models/update_airbnb_listing_room_request_beds_inner.rb +1 -1
  558. data/lib/repull/models/update_airbnb_listing_room_request_room_amenities_inner.rb +1 -1
  559. data/lib/repull/models/update_airbnb_listing_room_request_room_amenities_inner_value.rb +1 -1
  560. data/lib/repull/models/update_airbnb_listing_safety_disclosures200_response.rb +1 -1
  561. data/lib/repull/models/update_airbnb_message_request.rb +1 -1
  562. data/lib/repull/models/update_booking_charges_request.rb +1 -1
  563. data/lib/repull/models/update_booking_content_request.rb +1 -1
  564. data/lib/repull/models/update_booking_content_request_content_data_inner.rb +1 -1
  565. data/lib/repull/models/update_booking_content_request_photos_inner.rb +1 -1
  566. data/lib/repull/models/update_listing_pricing_strategy200_response.rb +1 -1
  567. data/lib/repull/models/update_webhook_request.rb +1 -1
  568. data/lib/repull/models/upload_airbnb_listing_photos_request.rb +1 -1
  569. data/lib/repull/models/upload_airbnb_listing_photos_request_photos_inner.rb +1 -1
  570. data/lib/repull/models/upload_airbnb_listing_photos_request_photos_inner_listing_id.rb +1 -1
  571. data/lib/repull/models/usage_quota_warning_event.rb +1 -1
  572. data/lib/repull/models/usage_quota_warning_payload.rb +1 -1
  573. data/lib/repull/models/usage_quota_warning_payload_top_operation.rb +1 -1
  574. data/lib/repull/models/vrbo_listing.rb +1 -1
  575. data/lib/repull/models/vrbo_reservation.rb +1 -1
  576. data/lib/repull/models/vrbo_reservation_list_response.rb +1 -1
  577. data/lib/repull/models/webhook_delivery.rb +1 -1
  578. data/lib/repull/models/webhook_delivery_detail.rb +1 -1
  579. data/lib/repull/models/webhook_delivery_list_response.rb +1 -1
  580. data/lib/repull/models/webhook_event.rb +7 -1
  581. data/lib/repull/models/webhook_event_account.rb +1 -1
  582. data/lib/repull/models/webhook_event_catalog.rb +1 -1
  583. data/lib/repull/models/webhook_event_catalog_domains_inner.rb +1 -1
  584. data/lib/repull/models/webhook_event_catalog_entry.rb +1 -1
  585. data/lib/repull/models/webhook_event_type.rb +5 -2
  586. data/lib/repull/models/webhook_list_response.rb +1 -1
  587. data/lib/repull/models/webhook_subscription.rb +1 -1
  588. data/lib/repull/models/withdraw_conversation_special_offer200_response.rb +1 -1
  589. data/lib/repull/version.rb +2 -2
  590. data/lib/repull.rb +32 -3
  591. data/openapi/v1.json +1357 -255
  592. metadata +33 -4
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -15,6 +15,8 @@ require 'time'
15
15
 
16
16
  module Repull
17
17
  class ListingListResponse < ApiModelBase
18
+ attr_accessor :plan_notice
19
+
18
20
  attr_accessor :data
19
21
 
20
22
  attr_accessor :pagination
@@ -22,6 +24,7 @@ module Repull
22
24
  # Attribute mapping from ruby-style variable name to JSON key.
23
25
  def self.attribute_map
24
26
  {
27
+ :'plan_notice' => :'planNotice',
25
28
  :'data' => :'data',
26
29
  :'pagination' => :'pagination'
27
30
  }
@@ -40,6 +43,7 @@ module Repull
40
43
  # Attribute type mapping.
41
44
  def self.openapi_types
42
45
  {
46
+ :'plan_notice' => :'PlanNotice',
43
47
  :'data' => :'Array<Listing>',
44
48
  :'pagination' => :'Pagination'
45
49
  }
@@ -67,6 +71,10 @@ module Repull
67
71
  h[k.to_sym] = v
68
72
  }
69
73
 
74
+ if attributes.key?(:'plan_notice')
75
+ self.plan_notice = attributes[:'plan_notice']
76
+ end
77
+
70
78
  if attributes.key?(:'data')
71
79
  if (value = attributes[:'data']).is_a?(Array)
72
80
  self.data = value
@@ -98,6 +106,7 @@ module Repull
98
106
  def ==(o)
99
107
  return true if self.equal?(o)
100
108
  self.class == o.class &&
109
+ plan_notice == o.plan_notice &&
101
110
  data == o.data &&
102
111
  pagination == o.pagination
103
112
  end
@@ -111,7 +120,7 @@ module Repull
111
120
  # Calculates hash code according to all attributes.
112
121
  # @return [Integer] Hash code
113
122
  def hash
114
- [data, pagination].hash
123
+ [plan_notice, data, pagination].hash
115
124
  end
116
125
 
117
126
  # Builds the object from hash
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -21,7 +21,7 @@ module Repull
21
21
  # Image MIME type. Must start with \"image/\".
22
22
  attr_accessor :file_type
23
23
 
24
- # File size in bytes, when known. Must be positive if provided.
24
+ # File size in bytes. Required: the signed upload is issued for this size.
25
25
  attr_accessor :file_size
26
26
 
27
27
  # Attribute mapping from ruby-style variable name to JSON key.
@@ -55,7 +55,6 @@ module Repull
55
55
  # List of attributes with nullable: true
56
56
  def self.openapi_nullable
57
57
  Set.new([
58
- :'file_size'
59
58
  ])
60
59
  end
61
60
 
@@ -89,6 +88,8 @@ module Repull
89
88
 
90
89
  if attributes.key?(:'file_size')
91
90
  self.file_size = attributes[:'file_size']
91
+ else
92
+ self.file_size = nil
92
93
  end
93
94
  end
94
95
 
@@ -105,6 +106,10 @@ module Repull
105
106
  invalid_properties.push('invalid value for "file_type", file_type cannot be nil.')
106
107
  end
107
108
 
109
+ if @file_size.nil?
110
+ invalid_properties.push('invalid value for "file_size", file_size cannot be nil.')
111
+ end
112
+
108
113
  invalid_properties
109
114
  end
110
115
 
@@ -114,6 +119,7 @@ module Repull
114
119
  warn '[DEPRECATED] the `valid?` method is obsolete'
115
120
  return false if @file_name.nil?
116
121
  return false if @file_type.nil?
122
+ return false if @file_size.nil?
117
123
  true
118
124
  end
119
125
 
@@ -137,6 +143,16 @@ module Repull
137
143
  @file_type = file_type
138
144
  end
139
145
 
146
+ # Custom attribute writer method with validation
147
+ # @param [Object] file_size Value to be assigned
148
+ def file_size=(file_size)
149
+ if file_size.nil?
150
+ fail ArgumentError, 'file_size cannot be nil'
151
+ end
152
+
153
+ @file_size = file_size
154
+ end
155
+
140
156
  # Checks equality by comparing each attribute.
141
157
  # @param [Object] Object to be compared
142
158
  def ==(o)
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -18,7 +18,7 @@ module Repull
18
18
  class ListingPhotoUploadUrlResponse < ApiModelBase
19
19
  attr_accessor :listing_id
20
20
 
21
- # PUT the raw file bytes here directly from the client. Not a Repull or vanio API endpoint — a signed storage URL.
21
+ # PUT the raw file bytes here directly from the client. Not a Repull API endpoint — a signed storage URL.
22
22
  attr_accessor :upload_url
23
23
 
24
24
  # Opaque upload token bound to this signed URL.
@@ -33,6 +33,9 @@ module Repull
33
33
  # Seconds until `uploadUrl` expires. Mint a new one via a fresh POST if the upload did not happen in time.
34
34
  attr_accessor :expires_in
35
35
 
36
+ # What to do after uploading. Uploading does NOT attach the photo to the listing: send `publicUrl` in `photos` on `PUT /v1/listings/{id}/content` (with `photosMode: \"append\"` to keep existing photos).
37
+ attr_accessor :next_step
38
+
36
39
  # Attribute mapping from ruby-style variable name to JSON key.
37
40
  def self.attribute_map
38
41
  {
@@ -41,7 +44,8 @@ module Repull
41
44
  :'token' => :'token',
42
45
  :'path' => :'path',
43
46
  :'public_url' => :'publicUrl',
44
- :'expires_in' => :'expiresIn'
47
+ :'expires_in' => :'expiresIn',
48
+ :'next_step' => :'nextStep'
45
49
  }
46
50
  end
47
51
 
@@ -63,7 +67,8 @@ module Repull
63
67
  :'token' => :'String',
64
68
  :'path' => :'String',
65
69
  :'public_url' => :'String',
66
- :'expires_in' => :'Integer'
70
+ :'expires_in' => :'Integer',
71
+ :'next_step' => :'String'
67
72
  }
68
73
  end
69
74
 
@@ -112,6 +117,10 @@ module Repull
112
117
  if attributes.key?(:'expires_in')
113
118
  self.expires_in = attributes[:'expires_in']
114
119
  end
120
+
121
+ if attributes.key?(:'next_step')
122
+ self.next_step = attributes[:'next_step']
123
+ end
115
124
  end
116
125
 
117
126
  # Show invalid properties with the reasons. Usually used together with valid?
@@ -139,7 +148,8 @@ module Repull
139
148
  token == o.token &&
140
149
  path == o.path &&
141
150
  public_url == o.public_url &&
142
- expires_in == o.expires_in
151
+ expires_in == o.expires_in &&
152
+ next_step == o.next_step
143
153
  end
144
154
 
145
155
  # @see the `==` method
@@ -151,7 +161,7 @@ module Repull
151
161
  # Calculates hash code according to all attributes.
152
162
  # @return [Integer] Hash code
153
163
  def hash
154
- [listing_id, upload_url, token, path, public_url, expires_in].hash
164
+ [listing_id, upload_url, token, path, public_url, expires_in, next_step].hash
155
165
  end
156
166
 
157
167
  # Builds the object from hash
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -18,7 +18,7 @@ module Repull
18
18
  class ListingPricingRecommendation < ApiModelBase
19
19
  attr_accessor :date
20
20
 
21
- # Current calendar price (from Vanio listings_calendar_days) before applying the recommendation.
21
+ # Current calendar price before applying the recommendation.
22
22
  attr_accessor :current_price
23
23
 
24
24
  # Atlas model's recommended price.
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10
 
@@ -4,7 +4,7 @@
4
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
- Contact: ivan@vanio.ai
7
+
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.22.0
10
10