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
 
@@ -28,13 +28,17 @@ module Repull
28
28
  # Minimum-stay requirement for a stay starting on this date. Falls back to the listing-level default min-nights when the calendar row carries none.
29
29
  attr_accessor :min_nights
30
30
 
31
+ # Units still sellable that night. 1 or 0 for a single home. For a hotel-model listing (a Mews or Cloudbeds room type) the rooms of that type left, e.g. 3 of 5 — see `GET /v1/listings/{id}/units`. `available` is false whenever this is 0.
32
+ attr_accessor :available_units
33
+
31
34
  # Attribute mapping from ruby-style variable name to JSON key.
32
35
  def self.attribute_map
33
36
  {
34
37
  :'date' => :'date',
35
38
  :'available' => :'available',
36
39
  :'price' => :'price',
37
- :'min_nights' => :'minNights'
40
+ :'min_nights' => :'minNights',
41
+ :'available_units' => :'availableUnits'
38
42
  }
39
43
  end
40
44
 
@@ -54,7 +58,8 @@ module Repull
54
58
  :'date' => :'Date',
55
59
  :'available' => :'Boolean',
56
60
  :'price' => :'Float',
57
- :'min_nights' => :'Integer'
61
+ :'min_nights' => :'Integer',
62
+ :'available_units' => :'Integer'
58
63
  }
59
64
  end
60
65
 
@@ -103,6 +108,12 @@ module Repull
103
108
  else
104
109
  self.min_nights = nil
105
110
  end
111
+
112
+ if attributes.key?(:'available_units')
113
+ self.available_units = attributes[:'available_units']
114
+ else
115
+ self.available_units = nil
116
+ end
106
117
  end
107
118
 
108
119
  # Show invalid properties with the reasons. Usually used together with valid?
@@ -126,6 +137,14 @@ module Repull
126
137
  invalid_properties.push('invalid value for "min_nights", min_nights cannot be nil.')
127
138
  end
128
139
 
140
+ if @available_units.nil?
141
+ invalid_properties.push('invalid value for "available_units", available_units cannot be nil.')
142
+ end
143
+
144
+ if @available_units < 0
145
+ invalid_properties.push('invalid value for "available_units", must be greater than or equal to 0.')
146
+ end
147
+
129
148
  invalid_properties
130
149
  end
131
150
 
@@ -137,6 +156,8 @@ module Repull
137
156
  return false if @available.nil?
138
157
  return false if @price.nil?
139
158
  return false if @min_nights.nil?
159
+ return false if @available_units.nil?
160
+ return false if @available_units < 0
140
161
  true
141
162
  end
142
163
 
@@ -180,6 +201,20 @@ module Repull
180
201
  @min_nights = min_nights
181
202
  end
182
203
 
204
+ # Custom attribute writer method with validation
205
+ # @param [Object] available_units Value to be assigned
206
+ def available_units=(available_units)
207
+ if available_units.nil?
208
+ fail ArgumentError, 'available_units cannot be nil'
209
+ end
210
+
211
+ if available_units < 0
212
+ fail ArgumentError, 'invalid value for "available_units", must be greater than or equal to 0.'
213
+ end
214
+
215
+ @available_units = available_units
216
+ end
217
+
183
218
  # Checks equality by comparing each attribute.
184
219
  # @param [Object] Object to be compared
185
220
  def ==(o)
@@ -188,7 +223,8 @@ module Repull
188
223
  date == o.date &&
189
224
  available == o.available &&
190
225
  price == o.price &&
191
- min_nights == o.min_nights
226
+ min_nights == o.min_nights &&
227
+ available_units == o.available_units
192
228
  end
193
229
 
194
230
  # @see the `==` method
@@ -200,7 +236,7 @@ module Repull
200
236
  # Calculates hash code according to all attributes.
201
237
  # @return [Integer] Hash code
202
238
  def hash
203
- [date, available, price, min_nights].hash
239
+ [date, available, price, min_nights, available_units].hash
204
240
  end
205
241
 
206
242
  # 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
 
@@ -15,6 +15,8 @@ require 'time'
15
15
 
16
16
  module Repull
17
17
  class PropertyListResponse < 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<Property>',
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
 
@@ -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
 
@@ -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
 
@@ -56,6 +56,8 @@ module Repull
56
56
  # Channel-side confirmation code (Airbnb HMxxx, Booking.com numeric, etc.).
57
57
  attr_accessor :confirmation_code
58
58
 
59
+ attr_accessor :unit
60
+
59
61
  # Inline guest summary. May be undefined for owner-blocks / pre-arrival rows.
60
62
  attr_accessor :primary_guest
61
63
 
@@ -103,6 +105,7 @@ module Repull
103
105
  :'source' => :'source',
104
106
  :'platform' => :'platform',
105
107
  :'confirmation_code' => :'confirmationCode',
108
+ :'unit' => :'unit',
106
109
  :'primary_guest' => :'primaryGuest',
107
110
  :'occupancy' => :'occupancy',
108
111
  :'financials' => :'financials',
@@ -143,6 +146,7 @@ module Repull
143
146
  :'source' => :'String',
144
147
  :'platform' => :'String',
145
148
  :'confirmation_code' => :'String',
149
+ :'unit' => :'ReservationUnit',
146
150
  :'primary_guest' => :'ReservationPrimaryGuest',
147
151
  :'occupancy' => :'ReservationOccupancy',
148
152
  :'financials' => :'ReservationFinancials',
@@ -163,6 +167,7 @@ module Repull
163
167
  :'check_out_time',
164
168
  :'source',
165
169
  :'platform',
170
+ :'unit',
166
171
  :'booked_at',
167
172
  :'guest_name'
168
173
  ])
@@ -252,6 +257,10 @@ module Repull
252
257
  self.confirmation_code = nil
253
258
  end
254
259
 
260
+ if attributes.key?(:'unit')
261
+ self.unit = attributes[:'unit']
262
+ end
263
+
255
264
  if attributes.key?(:'primary_guest')
256
265
  self.primary_guest = attributes[:'primary_guest']
257
266
  end
@@ -453,6 +462,7 @@ module Repull
453
462
  source == o.source &&
454
463
  platform == o.platform &&
455
464
  confirmation_code == o.confirmation_code &&
465
+ unit == o.unit &&
456
466
  primary_guest == o.primary_guest &&
457
467
  occupancy == o.occupancy &&
458
468
  financials == o.financials &&
@@ -474,7 +484,7 @@ module Repull
474
484
  # Calculates hash code according to all attributes.
475
485
  # @return [Integer] Hash code
476
486
  def hash
477
- [id, listing_id, guest_id, check_in, check_out, check_in_time, check_out_time, status, status_detail, pending_reason, respond_by, source, platform, confirmation_code, primary_guest, occupancy, financials, total_price, currency, guest_details, created_at, updated_at, booked_at, guest_name].hash
487
+ [id, listing_id, guest_id, check_in, check_out, check_in_time, check_out_time, status, status_detail, pending_reason, respond_by, source, platform, confirmation_code, unit, primary_guest, occupancy, financials, total_price, currency, guest_details, created_at, updated_at, booked_at, guest_name].hash
478
488
  end
479
489
 
480
490
  # 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