RubyGems - repull - Versions diffs - 0.2.32 → 0.2.34 - Mend

repull 0.2.32 → 0.2.34

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 (62) hide show

checksums.yaml +4 -4
data/README.md +1 -1
data/lib/repull/api/connections_api.rb +77 -0
data/lib/repull/api/promotions_api.rb +574 -0
data/lib/repull/api/resolutions_api.rb +236 -0
data/lib/repull/api/transactions_api.rb +73 -0
data/lib/repull/models/account_import.rb +237 -0
data/lib/repull/models/account_import_completed_event.rb +282 -0
data/lib/repull/models/account_import_counts.rb +193 -0
data/lib/repull/models/account_import_failed_event.rb +282 -0
data/lib/repull/models/account_import_finished_payload.rb +224 -0
data/lib/repull/models/account_import_stage.rb +177 -0
data/lib/repull/models/account_import_started_event.rb +282 -0
data/lib/repull/models/account_import_started_payload.rb +177 -0
data/lib/repull/models/connection.rb +16 -5
data/lib/repull/models/list_airbnb_resolutions200_response.rb +192 -0
data/lib/repull/models/list_connection_imports200_response.rb +158 -0
data/lib/repull/models/listing_updated_payload.rb +2 -2
data/lib/repull/models/promotion.rb +344 -0
data/lib/repull/models/promotion_applies_to.rb +161 -0
data/lib/repull/models/promotion_bulk_request.rb +236 -0
data/lib/repull/models/promotion_bulk_response.rb +158 -0
data/lib/repull/models/promotion_bulk_response_data_inner.rb +174 -0
data/lib/repull/models/promotion_bulk_response_data_inner_error.rb +165 -0
data/lib/repull/models/promotion_bulk_response_summary.rb +156 -0
data/lib/repull/models/promotion_catalog.rb +158 -0
data/lib/repull/models/promotion_catalog_channels_inner.rb +222 -0
data/lib/repull/models/promotion_catalog_entry.rb +265 -0
data/lib/repull/models/promotion_catalog_field.rb +205 -0
data/lib/repull/models/promotion_catalog_field_options_inner.rb +156 -0
data/lib/repull/models/promotion_catalog_response.rb +147 -0
data/lib/repull/models/promotion_create_request.rb +258 -0
data/lib/repull/models/promotion_delete_response.rb +147 -0
data/lib/repull/models/promotion_delete_response_data.rb +156 -0
data/lib/repull/models/promotion_discount.rb +191 -0
data/lib/repull/models/promotion_input.rb +241 -0
data/lib/repull/models/promotion_list_response.rb +170 -0
data/lib/repull/models/promotion_refresh_response.rb +170 -0
data/lib/repull/models/promotion_response.rb +147 -0
data/lib/repull/models/promotion_rules.rb +290 -0
data/lib/repull/models/promotion_rules_blackout_dates_quota.rb +156 -0
data/lib/repull/models/promotion_rules_booking_window.rb +230 -0
data/lib/repull/models/promotion_rules_last_minute.rb +218 -0
data/lib/repull/models/promotion_rules_stay_window.rb +211 -0
data/lib/repull/models/promotion_type.rb +47 -0
data/lib/repull/models/promotion_update_request.rb +175 -0
data/lib/repull/models/promotion_usage.rb +193 -0
data/lib/repull/models/promotion_usage_revenue.rb +156 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response.rb +219 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response_accounts_inner.rb +200 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response_accounts_inner_error.rb +156 -0
data/lib/repull/models/refresh_airbnb_resolutions_request.rb +192 -0
data/lib/repull/models/reservation_money_line.rb +14 -4
data/lib/repull/models/resolution.rb +329 -0
data/lib/repull/models/transaction_payout.rb +17 -6
data/lib/repull/models/webhook_event.rb +6 -0
data/lib/repull/models/webhook_event_type.rb +4 -1
data/lib/repull/version.rb +1 -1
data/lib/repull.rb +47 -0
data/openapi/v1.json +2211 -385
data/scripts/regen.sh +1 -1
metadata +49 -2

data/openapi/v1.json CHANGED Viewed

@@ -62,6 +62,10 @@
       "name": "Transactions",
       "description": "Unified transactions & payments ledger across channels \u2014 payouts, reservation charges, refunds. `booking` covers Booking.com however it was connected."
     },
+    {
+      "name": "Resolutions",
+      "description": "Airbnb Resolution Center cases (AirCover / damage, extra-guest, refund and change requests) \u2014 read-only visibility on open and closed resolutions. The money a resolution moved is in the transactions ledger; join on the resolution id."
+    },
     {
       "name": "Availability",
       "description": "Check and update property availability and pricing"
@@ -114,6 +118,10 @@
       "name": "AI",
       "description": "AI-powered operations \u2014 guest responses, intent classification, listing generation, pricing suggestions"
     },
+    {
+      "name": "Promotions",
+      "description": "Airbnb and Booking.com promotions on a listing, in one model: Airbnb\u2019s discount programmes (top-rated guests, mobile-only, new listing) and Booking.com deals, mobile and country rates and seasonal campaigns. Read the catalog first \u2014 it says, per channel, which types the listing can use and which fields each supports."
+    },
     {
       "name": "Pricing",
       "description": "Atlas-powered pricing recommendations and per-listing strategy. Recommendations are pre-computed by the Atlas pricing model from comp data, demand signals, and event calendars; this surface lets you read them, apply or decline them, and tune the strategy that constrains the model."
@@ -444,6 +452,10 @@
             "type": "number",
             "description": "VAT charged on top of this line, when the channel splits it out separately.",
             "example": 0
+          },
+          "promotionType": {
+            "type": "string",
+            "description": "Discount lines only: the listing promotion that produced the discount, named as in `GET /v1/listings/{id}/promotions` (Airbnb reports each applied promotion as its own line). `custom` is an Airbnb Custom promotion."
           }
         }
       },
@@ -1544,6 +1556,15 @@
             "format": "uri",
             "nullable": true,
             "description": "Durable link that reopens the hosted Connect flow bound to this account on the fix screen \u2014 send the host here to resolve `action`. Present only when `action.required` is true; `null` otherwise."
+          },
+          "import": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/AccountImport"
+              }
+            ],
+            "nullable": true,
+            "description": "The account's latest import \u2014 `status: running` while the first sync (or a later one) is going, then `completed` or `failed`. `null` when no import has been recorded. The same run is announced by the `account.import.*` webhooks; the history is on `GET /v1/connections/{id}/imports`."
           }
         }
       },
@@ -2673,6 +2694,9 @@
           "account.created",
           "connect.session.completed",
           "account.disconnected",
+          "account.import.started",
+          "account.import.completed",
+          "account.import.failed",
           "review.created",
           "review.responded",
           "ai.operation.completed",
@@ -3630,7 +3654,7 @@
       },
       "ListingUpdatedPayload": {
         "type": "object",
-        "description": "Payload for `listing.updated`. Something about the listing changed on the channel \u2014 content, pricing, booking settings, house rules, availability or sync settings.",
+        "description": "Payload for `listing.updated`. Something about the listing changed on the channel \u2014 content, pricing, booking settings, house rules, availability, sync settings or promotions.",
         "required": [
           "object"
         ],
@@ -3640,7 +3664,7 @@
           },
           "area": {
             "type": "string",
-            "description": "Which part moved. Airbnb sends one notification per area rather than a diff, so this is the signal for what to re-read.",
+            "description": "Which part moved. Airbnb sends one notification per area rather than a diff, so this is the signal for what to re-read. `promotions`: the listing\u2019s Airbnb or Booking.com promotions changed \u2014 re-read `GET /v1/listings/{id}/promotions`.",
             "example": "content"
           },
           "previousAttributes": {
@@ -4890,259 +4914,528 @@
           }
         }
       },
-      "ConnectSessionCompletedEvent": {
+      "AccountImportStage": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "One stage of an account import (e.g. `reservations`). The stage is done when `done + failed` reaches `expected`.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
-          },
-          "apiVersion": {
+          "name": {
             "type": "string",
-            "example": "2026-04"
+            "example": "reservations"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "expected": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Units of work in this stage (one per page, chunk, listing or thread, depending on the channel). `null` until the stage knows its size."
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "done": {
+            "type": "integer"
           },
-          "data": {
-            "$ref": "#/components/schemas/ConnectSessionCompletedPayload"
+          "failed": {
+            "type": "integer"
           }
         }
       },
-      "AccountDisconnectedEvent": {
+      "AccountImportCounts": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "What the import brought in. A channel reports the keys it imports.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+          "listings": {
+            "type": "integer"
           },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          "reservations": {
+            "type": "integer"
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "conversations": {
+            "type": "integer"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "messages": {
+            "type": "integer"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "reviews": {
+            "type": "integer"
           },
-          "data": {
-            "$ref": "#/components/schemas/AccountDisconnectedPayload"
+          "payments": {
+            "type": "integer"
           }
         }
       },
-      "ReviewCreatedEvent": {
+      "AccountImport": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "One import run of a connected account: the first sync after connecting, a room or unit mapped later, a reconnect or a re-sync.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
+          "id": {
             "type": "string",
             "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "description": "The import id \u2014 the `importId` on `account.import.*` webhooks."
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "status": {
+            "type": "string"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "trigger": {
+            "type": "string"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "outcome": {
+            "type": "string",
+            "nullable": true,
+            "description": "`completed` imports only: `partial` when some units failed (see `stages`)."
           },
-          "data": {
-            "$ref": "#/components/schemas/ReviewCreatedPayload"
-          }
-        }
-      },
-      "ReviewRespondedEvent": {
-        "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
-        "properties": {
-          "event": {
+          "reason": {
             "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+            "nullable": true,
+            "description": "`failed` imports only: why it stopped \u2014 e.g. `needs_permissions`, `duplicate_account`, `stalled`."
           },
-          "eventId": {
+          "startedAt": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "date-time"
           },
-          "apiVersion": {
+          "lastActivityAt": {
             "type": "string",
-            "example": "2026-04"
+            "format": "date-time"
           },
-          "timestamp": {
+          "completedAt": {
             "type": "string",
             "format": "date-time",
-            "description": "When this delivery was built."
+            "nullable": true
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "stages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountImportStage"
+            }
           },
-          "data": {
-            "$ref": "#/components/schemas/ReviewRespondedPayload"
+          "counts": {
+            "$ref": "#/components/schemas/AccountImportCounts"
           }
         }
       },
-      "AiOperationCompletedEvent": {
+      "AccountImportStartedPayload": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
+          "importId": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "uuid"
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "trigger": {
+            "type": "string"
           },
-          "timestamp": {
+          "startedAt": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
-          },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+            "format": "date-time"
           },
-          "data": {
-            "$ref": "#/components/schemas/AiOperationCompletedPayload"
+          "stages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The stages this import will run."
           }
         }
       },
-      "AiOperationFailedEvent": {
+      "AccountImportFinishedPayload": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
-          },
-          "apiVersion": {
+          "importId": {
             "type": "string",
-            "example": "2026-04"
+            "format": "uuid"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "trigger": {
+            "type": "string"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "status": {
+            "type": "string"
           },
-          "data": {
-            "$ref": "#/components/schemas/AiOperationFailedPayload"
-          }
-        }
-      },
-      "PaymentCompletedEvent": {
-        "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
-        "properties": {
-          "event": {
+          "outcome": {
             "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+            "nullable": true
           },
-          "eventId": {
+          "startedAt": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "date-time"
           },
-          "apiVersion": {
+          "completedAt": {
             "type": "string",
-            "example": "2026-04"
+            "format": "date-time"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "stages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountImportStage"
+            }
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "counts": {
+            "$ref": "#/components/schemas/AccountImportCounts"
           },
-          "data": {
-            "$ref": "#/components/schemas/PaymentCompletedPayload"
+          "reason": {
+            "type": "string",
+            "nullable": true,
+            "description": "`account.import.failed` only."
           }
         }
       },
-      "PayoutCompletedEvent": {
+      "AccountImportStartedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportStartedPayload"
+          }
+        },
+        "description": "An account import began."
+      },
+      "AccountImportCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportFinishedPayload"
+          }
+        },
+        "description": "Every stage of an account import finished. Its data is readable through the API."
+      },
+      "AccountImportFailedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportFinishedPayload"
+          }
+        },
+        "description": "An account import stopped before finishing; `data.reason` says why."
+      },
+      "ConnectSessionCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ConnectSessionCompletedPayload"
+          }
+        }
+      },
+      "AccountDisconnectedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountDisconnectedPayload"
+          }
+        }
+      },
+      "ReviewCreatedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ReviewCreatedPayload"
+          }
+        }
+      },
+      "ReviewRespondedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ReviewRespondedPayload"
+          }
+        }
+      },
+      "AiOperationCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AiOperationCompletedPayload"
+          }
+        }
+      },
+      "AiOperationFailedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AiOperationFailedPayload"
+          }
+        }
+      },
+      "PaymentCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/PaymentCompletedPayload"
+          }
+        }
+      },
+      "PayoutCompletedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -5489,6 +5782,15 @@
           {
             "$ref": "#/components/schemas/AccountDisconnectedEvent"
           },
+          {
+            "$ref": "#/components/schemas/AccountImportStartedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/AccountImportCompletedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/AccountImportFailedEvent"
+          },
           {
             "$ref": "#/components/schemas/ReviewCreatedEvent"
           },
@@ -5547,6 +5849,9 @@
             "account.created": "#/components/schemas/AccountCreatedEvent",
             "connect.session.completed": "#/components/schemas/ConnectSessionCompletedEvent",
             "account.disconnected": "#/components/schemas/AccountDisconnectedEvent",
+            "account.import.started": "#/components/schemas/AccountImportStartedEvent",
+            "account.import.completed": "#/components/schemas/AccountImportCompletedEvent",
+            "account.import.failed": "#/components/schemas/AccountImportFailedEvent",
             "review.created": "#/components/schemas/ReviewCreatedEvent",
             "review.responded": "#/components/schemas/ReviewRespondedEvent",
             "ai.operation.completed": "#/components/schemas/AiOperationCompletedEvent",
@@ -7408,7 +7713,13 @@
               "statementUrl": {
                 "type": "string",
                 "nullable": true,
-                "description": "Link to the channel's original payout statement PDF \u2014 the authoritative settlement record (Booking.com). Null when none."
+                "description": "Repull-hosted download link for the original payout statement PDF (the authoritative settlement record). Add `?format=csv` for the CSV. Served by `GET /v1/transactions/{id}/statement` \u2014 no channel session needed. Null when none is stored."
+              },
+              "statementId": {
+                "type": "string",
+                "nullable": true,
+                "description": "The channel's own numeric statement id (Booking.com, e.g. \"010747030095\"). Null when none.",
+                "example": "010747030095"
               }
             }
           },
@@ -7432,6 +7743,97 @@
           }
         }
       },
+      "Resolution": {
+        "type": "object",
+        "description": "An Airbnb Resolution Center case (AirCover / damage, extra-guest, refund or change request). Read-only \u2014 Airbnb exposes no create/evidence/status API. The money a resolution moved rides in the transactions ledger as `Resolution Payout` / `Resolution Adjustment` rows sharing the same reference; join on `resolutionId`.",
+        "required": [
+          "resolutionId",
+          "status"
+        ],
+        "properties": {
+          "resolutionId": {
+            "type": "string",
+            "description": "Airbnb's resolution id \u2014 the `{id}` path value and the join key to a transaction's `reference`.",
+            "example": "CLSF-06464054"
+          },
+          "confirmationCode": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb confirmation code of the reservation the case is on.",
+            "example": "HMZKMYCBC5"
+          },
+          "reservationId": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Repull's internal reservation id, when the reservation is in this workspace."
+          },
+          "listingName": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "nullable": true,
+            "description": "OPEN or CLOSED, as Airbnb reports it.",
+            "example": "OPEN"
+          },
+          "reason": {
+            "type": "string",
+            "nullable": true,
+            "description": "Why the resolution was opened."
+          },
+          "caseStatus": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb's case-status label."
+          },
+          "statusText": {
+            "type": "string",
+            "nullable": true,
+            "description": "Human-readable status detail."
+          },
+          "suggestedActionText": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb's hint on whose turn it is to act next \u2014 track progress with it."
+          },
+          "customerSupportInitiated": {
+            "type": "boolean",
+            "nullable": true,
+            "description": "True when Airbnb Customer Support (not the host/guest) opened the case."
+          },
+          "productType": {
+            "type": "string",
+            "nullable": true
+          },
+          "initiator": {
+            "type": "object",
+            "nullable": true,
+            "description": "Who opened the case (id + name)."
+          },
+          "responder": {
+            "type": "object",
+            "nullable": true,
+            "description": "Who responds (id + name)."
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When Repull last refreshed this case from Airbnb."
+          }
+        }
+      },
       "AirbnbConnectionHost": {
         "type": "object",
         "description": "One Airbnb host record under the workspace, decorated with its most recent disconnect reason from `airbnb_host_events` (backfill events excluded).",
@@ -9298,301 +9700,919 @@
           }
         }
       },
-      "ListingPricingResponse": {
+      "Promotion": {
         "type": "object",
+        "description": "One promotion on one listing. Airbnb sets the discount for its promotions (`discount.setBy: channel`); Booking.com promotions belong to the property and list the rooms they cover in `appliesTo`.",
         "properties": {
+          "id": {
+            "type": "string",
+            "description": "Repull id of this promotion on this listing (use it in `/promotions/{promotionId}`)."
+          },
           "listingId": {
             "type": "string"
           },
-          "dateRange": {
+          "channel": {
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
+          },
+          "channelType": {
+            "type": "string",
+            "description": "The channel\u2019s own name, e.g. `HIGH_RATED_GUEST_DISCOUNT`, `basic`, `campaign_getaway`."
+          },
+          "externalId": {
+            "type": "string",
+            "description": "The channel\u2019s promotion id. Booking.com may issue a new one when a promotion is changed; the Repull `id` stays the same."
+          },
+          "channelPropertyId": {
+            "type": "string",
+            "description": "Airbnb listing id, or the Booking.com property (hotel id) the promotion belongs to."
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "description": "`eligible`: the listing qualifies but is not enrolled (Airbnb new listing promotion). `inactive`: switched off; Booking.com keeps deactivated promotions."
+          },
+          "managedBy": {
+            "type": "string",
+            "description": "`channel`: created in the channel\u2019s own tools and read-only here (Airbnb Custom promotions)."
+          },
+          "managedKey": {
+            "type": "string",
+            "nullable": true,
+            "description": "Set when it comes from the listing\u2019s weekly or monthly discount in its pricing settings \u2014 change those instead."
+          },
+          "editable": {
+            "type": "boolean"
+          },
+          "removable": {
+            "type": "boolean"
+          },
+          "discount": {
             "type": "object",
             "properties": {
-              "start": {
-                "type": "string",
-                "format": "date"
+              "percent": {
+                "type": "number",
+                "nullable": true
               },
-              "end": {
+              "setBy": {
                 "type": "string",
-                "format": "date"
+                "enum": [
+                  "host",
+                  "channel"
+                ]
               }
             }
           },
-          "recommendations": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/ListingPricingRecommendation"
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
+          },
+          "appliesTo": {
+            "type": "object",
+            "nullable": true,
+            "description": "Booking.com only. An empty `rooms` list means every room on the property.",
+            "properties": {
+              "rooms": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "ratePlans": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
             }
           },
-          "listing": {
+          "usage": {
             "type": "object",
             "nullable": true,
-            "description": "AI-derived base-price context for the listing.",
             "properties": {
-              "aiBasePrice": {
-                "type": "number",
-                "nullable": true
+              "bookings": {
+                "type": "integer"
               },
-              "aiBasePriceFactors": {
+              "roomNights": {
+                "type": "integer"
+              },
+              "cancellations": {
+                "type": "integer"
+              },
+              "revenue": {
                 "type": "object",
-                "additionalProperties": true,
-                "nullable": true
+                "properties": {
+                  "amount": {
+                    "type": "number"
+                  },
+                  "currency": {
+                    "type": "string"
+                  }
+                }
               },
-              "qualityTier": {
+              "lastAppliedAt": {
                 "type": "string",
-                "nullable": true
+                "format": "date-time",
+                "description": "Airbnb Custom promotion: when it was last applied to a booking."
               },
-              "segment": {
+              "lastAppliedAmount": {
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "type": "number"
+                  },
+                  "currency": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "expiresAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "PromotionType": {
+        "type": "string",
+        "enum": [
+          "new_listing",
+          "mobile",
+          "top_rated_guests",
+          "deal",
+          "last_minute",
+          "early_booker",
+          "country",
+          "campaign",
+          "custom"
+        ],
+        "description": "The same idea on both channels shares a type: `mobile` is Airbnb\u2019s mobile-only discount or Booking.com\u2019s mobile rate; `new_listing` is Airbnb\u2019s new listing promotion or Booking.com\u2019s new property deal. `top_rated_guests` is Airbnb only; the deal, last-minute, early-booker, country and campaign types are Booking.com only; `custom` (Airbnb Custom promotion) is read-only."
+      },
+      "PromotionRules": {
+        "type": "object",
+        "description": "Which rules a type supports depends on the channel \u2014 see the catalog.",
+        "properties": {
+          "campaign": {
+            "type": "string",
+            "description": "Booking.com campaigns: `black_friday`, `getaway`, `late_escape`, `early_year`."
+          },
+          "audience": {
+            "type": "string",
+            "description": "`public`, `subscribers` (members only, at least 10%), `app`, `all` (app and mobile web), or a country id from the catalog (e.g. `united_kingdom_pos`)."
+          },
+          "stayWindow": {
+            "type": "object",
+            "properties": {
+              "start": {
                 "type": "string",
-                "nullable": true
+                "format": "date"
               },
-              "currency": {
+              "end": {
                 "type": "string",
-                "nullable": true
+                "format": "date"
+              },
+              "weekdays": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "mon",
+                    "tue",
+                    "wed",
+                    "thu",
+                    "fri",
+                    "sat",
+                    "sun"
+                  ]
+                }
+              },
+              "excludedDates": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "format": "date"
+                }
+              },
+              "additionalDates": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "format": "date"
+                }
               }
             }
           },
-          "compSummary": {
+          "bookingWindow": {
             "type": "object",
-            "nullable": true,
-            "description": "5km comp aggregate (Atlas comp_listings).",
             "properties": {
-              "count": {
-                "type": "integer"
+              "start": {
+                "type": "string",
+                "format": "date"
               },
-              "avgPrice": {
-                "type": "number",
-                "nullable": true
+              "end": {
+                "type": "string",
+                "format": "date"
               },
-              "minPrice": {
-                "type": "number",
-                "nullable": true
+              "startHour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23
               },
-              "maxPrice": {
-                "type": "number",
-                "nullable": true
+              "endHour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23
               }
             }
-          }
-        }
-      },
-      "ListingPricingApplyRequest": {
-        "type": "object",
-        "required": [
-          "dates",
-          "action"
-        ],
-        "properties": {
-          "dates": {
+          },
+          "lastMinute": {
+            "type": "object",
+            "properties": {
+              "unit": {
+                "type": "string",
+                "enum": [
+                  "day",
+                  "hour"
+                ]
+              },
+              "value": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000
+              }
+            }
+          },
+          "earlyBookerDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500
+          },
+          "minNights": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 30
+          },
+          "nonRefundable": {
+            "type": "boolean"
+          },
+          "blackoutDates": {
             "type": "array",
             "items": {
               "type": "string",
               "format": "date"
             },
-            "description": "Dates the action applies to. Must match dates that have a `pending` recommendation; others are silently skipped."
+            "description": "Airbnb \u2014 not yet available."
           },
-          "action": {
-            "type": "string"
+          "blackoutDatesQuota": {
+            "type": "object",
+            "properties": {
+              "used": {
+                "type": "integer"
+              },
+              "available": {
+                "type": "integer"
+              }
+            }
           }
         }
       },
-      "ListingPricingApplyResponse": {
+      "PromotionInput": {
         "type": "object",
+        "required": [
+          "channel",
+          "type"
+        ],
         "properties": {
-          "ok": {
-            "type": "boolean"
+          "channel": {
+            "type": "string"
           },
-          "applied": {
-            "type": "integer",
-            "nullable": true,
-            "description": "Number of recommendations applied (apply action only)."
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
           },
-          "declined": {
+          "name": {
+            "type": "string",
+            "description": "Booking.com only; only you see it."
+          },
+          "discountPercent": {
             "type": "integer",
-            "nullable": true,
-            "description": "Number of dates declined (decline action only)."
+            "description": "Booking.com only \u2014 Airbnb sets its own rates. Limits per type are in the catalog."
+          },
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
           }
         }
       },
-      "ListingPricingStrategy": {
+      "PromotionCreateRequest": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/PromotionInput"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "hotelId": {
+                "type": "string",
+                "description": "Booking.com: required when the listing has a room on more than one property (see `properties` in the catalog)."
+              }
+            }
+          }
+        ]
+      },
+      "PromotionUpdateRequest": {
         "type": "object",
-        "description": "Strategy that constrains the Atlas pricing model for one listing.",
         "properties": {
-          "id": {
-            "type": "string",
-            "nullable": true
-          },
-          "listingId": {
-            "type": "string"
-          },
-          "customerId": {
+          "name": {
             "type": "string"
           },
-          "mode": {
-            "type": "string",
-            "description": "`recommend` surfaces suggestions; `auto` applies them on the next sync."
-          },
-          "minPrice": {
-            "type": "number",
-            "nullable": true
-          },
-          "maxPrice": {
-            "type": "number",
-            "nullable": true
-          },
-          "maxDailyChangePct": {
-            "type": "number",
-            "description": "Max day-over-day swing in %.",
-            "default": 15
-          },
-          "weekendMarkupPct": {
-            "type": "number",
-            "nullable": true,
-            "description": "% bump applied on Fri/Sat."
-          },
-          "dayOfWeekMultipliers": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "number"
-            },
-            "description": "Multiplier per ISO weekday key (0..6)."
+          "discountPercent": {
+            "type": "integer"
           },
-          "targetOccupancyPct": {
-            "type": "number",
-            "nullable": true
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
           },
-          "targetMonthlyRevenue": {
-            "type": "number",
-            "nullable": true
+          "confirmShared": {
+            "type": "boolean",
+            "description": "Required when the promotion also covers other listings\u2019 rooms \u2014 the change applies to them too."
+          }
+        }
+      },
+      "PromotionCatalogField": {
+        "type": "object",
+        "properties": {
+          "supported": {
+            "type": "boolean"
           },
-          "ownerMinMonthlyPayout": {
-            "type": "number",
-            "nullable": true
+          "comingSoon": {
+            "type": "boolean",
+            "description": "Shown but not yet usable on this channel."
           },
-          "compPositionTarget": {
-            "type": "string",
-            "default": "match"
+          "required": {
+            "type": "boolean"
           },
-          "compAdjustPct": {
-            "type": "number",
-            "description": "Extra adjustment vs comp median (-30..+30).",
-            "default": 0
+          "min": {
+            "type": "number"
           },
-          "eventBoostEnabled": {
-            "type": "boolean",
-            "default": true
+          "max": {
+            "type": "number"
           },
-          "eventBoostMaxPct": {
+          "fixed": {
             "type": "number",
-            "default": 30
+            "description": "Value the channel sets (e.g. Airbnb\u2019s 15% top-rated-guests discount)."
           },
-          "isDefault": {
-            "type": "boolean",
-            "description": "true when no row exists yet and the response is server-side defaults."
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                }
+              }
+            }
           }
         }
       },
-      "ListingPricingStrategyInput": {
+      "PromotionCatalogEntry": {
         "type": "object",
-        "description": "Same shape as `ListingPricingStrategy` minus the read-only fields. Send only fields you want to change.",
         "properties": {
-          "mode": {
+          "channel": {
             "type": "string"
           },
-          "minPrice": {
-            "type": "number",
-            "nullable": true
-          },
-          "maxPrice": {
-            "type": "number",
-            "nullable": true
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
           },
-          "maxDailyChangePct": {
-            "type": "number"
+          "channelType": {
+            "type": "string"
           },
-          "weekendMarkupPct": {
-            "type": "number",
-            "nullable": true
+          "campaign": {
+            "type": "string"
           },
-          "dayOfWeekMultipliers": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "number"
-            }
+          "label": {
+            "type": "string"
           },
-          "targetOccupancyPct": {
-            "type": "number",
-            "nullable": true
+          "description": {
+            "type": "string",
+            "description": "One or two sentences to show hosts."
           },
-          "targetMonthlyRevenue": {
-            "type": "number",
-            "nullable": true
+          "isNew": {
+            "type": "boolean",
+            "description": "Newly available \u2014 show a \u201cNew\u201d badge."
           },
-          "ownerMinMonthlyPayout": {
-            "type": "number",
-            "nullable": true
+          "available": {
+            "type": "boolean"
           },
-          "compPositionTarget": {
+          "unavailableReason": {
             "type": "string"
           },
-          "compAdjustPct": {
-            "type": "number"
-          },
-          "eventBoostEnabled": {
-            "type": "boolean"
+          "single": {
+            "type": "boolean",
+            "description": "Only one at a time (Airbnb types; Booking.com mobile and country rates per property)."
           },
-          "eventBoostMaxPct": {
-            "type": "number"
+          "fields": {
+            "type": "object",
+            "description": "Every field, supported or not, so a UI can grey out what a type does not take.",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/PromotionCatalogField"
+            }
           }
         }
       },
-      "BulkPricingItem": {
+      "PromotionCatalog": {
         "type": "object",
-        "required": [
-          "listingId",
-          "dates"
-        ],
-        "description": "A single (listingId, dates) pair in a bulk pricing request. The action in the parent request body applies to every date in `dates` for this listing.",
         "properties": {
           "listingId": {
-            "type": "string",
-            "example": "4118"
+            "type": "string"
           },
-          "dates": {
+          "channels": {
             "type": "array",
             "items": {
-              "type": "string",
-              "format": "date"
-            },
-            "minItems": 1,
-            "example": [
-              "2026-05-14",
-              "2026-05-15"
-            ]
+              "type": "object",
+              "properties": {
+                "channel": {
+                  "type": "string",
+                  "enum": [
+                    "airbnb",
+                    "booking"
+                  ]
+                },
+                "connected": {
+                  "type": "boolean"
+                },
+                "reason": {
+                  "type": "string"
+                },
+                "properties": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Booking.com properties the listing has a room on."
+                },
+                "entries": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/PromotionCatalogEntry"
+                  }
+                }
+              }
+            }
           }
         }
       },
-      "BulkPricingRequest": {
+      "PromotionListResponse": {
         "type": "object",
-        "required": [
-          "action",
-          "items"
-        ],
-        "description": "Body for `POST /v1/listings/pricing/bulk`. Apply or decline pending Atlas pricing recommendations across many listings in one call. Capped at 500 items per request \u2014 exceeding returns 422.",
         "properties": {
-          "action": {
-            "type": "string",
-            "description": "`apply` writes the recommended price to each listing's calendar and fans out to channels (Airbnb/Booking/VRBO). `decline` marks the recommendations as `declined` so they stop surfacing."
-          },
-          "items": {
+          "data": {
             "type": "array",
-            "minItems": 1,
-            "maxItems": 500,
             "items": {
-              "$ref": "#/components/schemas/BulkPricingItem"
+              "$ref": "#/components/schemas/Promotion"
             }
-          }
-        }
-      },
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the channels were last read for this listing."
+          },
+          "syncError": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "PromotionResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/Promotion"
+          }
+        }
+      },
+      "PromotionDeleteResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "removed": {
+                "type": "boolean"
+              },
+              "promotionId": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "PromotionCatalogResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/PromotionCatalog"
+          }
+        }
+      },
+      "PromotionRefreshResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Promotion"
+            }
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "PromotionBulkRequest": {
+        "type": "object",
+        "required": [
+          "listingIds",
+          "action",
+          "promotion"
+        ],
+        "properties": {
+          "listingIds": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "minItems": 1,
+            "maxItems": 100
+          },
+          "action": {
+            "type": "string"
+          },
+          "promotion": {
+            "$ref": "#/components/schemas/PromotionInput"
+          }
+        }
+      },
+      "PromotionBulkResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "listingId": {
+                  "type": "string"
+                },
+                "ok": {
+                  "type": "boolean"
+                },
+                "promotion": {
+                  "$ref": "#/components/schemas/Promotion"
+                },
+                "error": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "field": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "summary": {
+            "type": "object",
+            "properties": {
+              "succeeded": {
+                "type": "integer"
+              },
+              "failed": {
+                "type": "integer"
+              }
+            }
+          }
+        }
+      },
+      "ListingPricingResponse": {
+        "type": "object",
+        "properties": {
+          "listingId": {
+            "type": "string"
+          },
+          "dateRange": {
+            "type": "object",
+            "properties": {
+              "start": {
+                "type": "string",
+                "format": "date"
+              },
+              "end": {
+                "type": "string",
+                "format": "date"
+              }
+            }
+          },
+          "recommendations": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ListingPricingRecommendation"
+            }
+          },
+          "listing": {
+            "type": "object",
+            "nullable": true,
+            "description": "AI-derived base-price context for the listing.",
+            "properties": {
+              "aiBasePrice": {
+                "type": "number",
+                "nullable": true
+              },
+              "aiBasePriceFactors": {
+                "type": "object",
+                "additionalProperties": true,
+                "nullable": true
+              },
+              "qualityTier": {
+                "type": "string",
+                "nullable": true
+              },
+              "segment": {
+                "type": "string",
+                "nullable": true
+              },
+              "currency": {
+                "type": "string",
+                "nullable": true
+              }
+            }
+          },
+          "compSummary": {
+            "type": "object",
+            "nullable": true,
+            "description": "5km comp aggregate (Atlas comp_listings).",
+            "properties": {
+              "count": {
+                "type": "integer"
+              },
+              "avgPrice": {
+                "type": "number",
+                "nullable": true
+              },
+              "minPrice": {
+                "type": "number",
+                "nullable": true
+              },
+              "maxPrice": {
+                "type": "number",
+                "nullable": true
+              }
+            }
+          }
+        }
+      },
+      "ListingPricingApplyRequest": {
+        "type": "object",
+        "required": [
+          "dates",
+          "action"
+        ],
+        "properties": {
+          "dates": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "date"
+            },
+            "description": "Dates the action applies to. Must match dates that have a `pending` recommendation; others are silently skipped."
+          },
+          "action": {
+            "type": "string"
+          }
+        }
+      },
+      "ListingPricingApplyResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "applied": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Number of recommendations applied (apply action only)."
+          },
+          "declined": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Number of dates declined (decline action only)."
+          }
+        }
+      },
+      "ListingPricingStrategy": {
+        "type": "object",
+        "description": "Strategy that constrains the Atlas pricing model for one listing.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "nullable": true
+          },
+          "listingId": {
+            "type": "string"
+          },
+          "customerId": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string",
+            "description": "`recommend` surfaces suggestions; `auto` applies them on the next sync."
+          },
+          "minPrice": {
+            "type": "number",
+            "nullable": true
+          },
+          "maxPrice": {
+            "type": "number",
+            "nullable": true
+          },
+          "maxDailyChangePct": {
+            "type": "number",
+            "description": "Max day-over-day swing in %.",
+            "default": 15
+          },
+          "weekendMarkupPct": {
+            "type": "number",
+            "nullable": true,
+            "description": "% bump applied on Fri/Sat."
+          },
+          "dayOfWeekMultipliers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number"
+            },
+            "description": "Multiplier per ISO weekday key (0..6)."
+          },
+          "targetOccupancyPct": {
+            "type": "number",
+            "nullable": true
+          },
+          "targetMonthlyRevenue": {
+            "type": "number",
+            "nullable": true
+          },
+          "ownerMinMonthlyPayout": {
+            "type": "number",
+            "nullable": true
+          },
+          "compPositionTarget": {
+            "type": "string",
+            "default": "match"
+          },
+          "compAdjustPct": {
+            "type": "number",
+            "description": "Extra adjustment vs comp median (-30..+30).",
+            "default": 0
+          },
+          "eventBoostEnabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "eventBoostMaxPct": {
+            "type": "number",
+            "default": 30
+          },
+          "isDefault": {
+            "type": "boolean",
+            "description": "true when no row exists yet and the response is server-side defaults."
+          }
+        }
+      },
+      "ListingPricingStrategyInput": {
+        "type": "object",
+        "description": "Same shape as `ListingPricingStrategy` minus the read-only fields. Send only fields you want to change.",
+        "properties": {
+          "mode": {
+            "type": "string"
+          },
+          "minPrice": {
+            "type": "number",
+            "nullable": true
+          },
+          "maxPrice": {
+            "type": "number",
+            "nullable": true
+          },
+          "maxDailyChangePct": {
+            "type": "number"
+          },
+          "weekendMarkupPct": {
+            "type": "number",
+            "nullable": true
+          },
+          "dayOfWeekMultipliers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number"
+            }
+          },
+          "targetOccupancyPct": {
+            "type": "number",
+            "nullable": true
+          },
+          "targetMonthlyRevenue": {
+            "type": "number",
+            "nullable": true
+          },
+          "ownerMinMonthlyPayout": {
+            "type": "number",
+            "nullable": true
+          },
+          "compPositionTarget": {
+            "type": "string"
+          },
+          "compAdjustPct": {
+            "type": "number"
+          },
+          "eventBoostEnabled": {
+            "type": "boolean"
+          },
+          "eventBoostMaxPct": {
+            "type": "number"
+          }
+        }
+      },
+      "BulkPricingItem": {
+        "type": "object",
+        "required": [
+          "listingId",
+          "dates"
+        ],
+        "description": "A single (listingId, dates) pair in a bulk pricing request. The action in the parent request body applies to every date in `dates` for this listing.",
+        "properties": {
+          "listingId": {
+            "type": "string",
+            "example": "4118"
+          },
+          "dates": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "date"
+            },
+            "minItems": 1,
+            "example": [
+              "2026-05-14",
+              "2026-05-15"
+            ]
+          }
+        }
+      },
+      "BulkPricingRequest": {
+        "type": "object",
+        "required": [
+          "action",
+          "items"
+        ],
+        "description": "Body for `POST /v1/listings/pricing/bulk`. Apply or decline pending Atlas pricing recommendations across many listings in one call. Capped at 500 items per request \u2014 exceeding returns 422.",
+        "properties": {
+          "action": {
+            "type": "string",
+            "description": "`apply` writes the recommended price to each listing's calendar and fans out to channels (Airbnb/Booking/VRBO). `decline` marks the recommendations as `declined` so they stop surfacing."
+          },
+          "items": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 500,
+            "items": {
+              "$ref": "#/components/schemas/BulkPricingItem"
+            }
+          }
+        }
+      },
       "BulkPricingFailure": {
         "type": "object",
         "description": "Per-item failure entry. Per-item failures DO NOT fail the whole batch \u2014 partial-success is the norm at this scale.",
@@ -37672,6 +38692,812 @@
           }
         }
       }
+    },
+    "/v1/transactions/{id}/statement": {
+      "get": {
+        "operationId": "get_transaction_statement",
+        "summary": "Download the original payout statement",
+        "description": "Downloads the channel's ORIGINAL payout statement \u2014 the authoritative settlement record a host reconciles against \u2014 for a payout transaction. `{id}` is the payout `transactionId` (e.g. `booking_payout_5463377687_bank_transfer`). Repull serves the stored bytes itself (no channel session), so unlike the channel's own link it never expires or leaks a session. PDF by default; pass `?format=csv` for the CSV remittance. Returns `404` when no statement was captured for the payout (e.g. an upcoming payout, or a channel that has none).",
+        "tags": [
+          "Transactions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The payout transaction id (`transactionId`).",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "required": false,
+            "description": "Statement format.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pdf",
+                "csv"
+              ],
+              "default": "pdf"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The statement file (PDF by default, or CSV).",
+            "content": {
+              "application/pdf": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/channels/airbnb/resolutions": {
+      "get": {
+        "operationId": "list_airbnb_resolutions",
+        "summary": "List Airbnb Resolution Center cases",
+        "description": "The host's Airbnb Resolution Center cases (AirCover / damage, extra-guest, refund and change requests), open and closed. Served from the database; `POST` this path to refresh from Airbnb. READ-ONLY upstream \u2014 Airbnb's Resolutions API is read-only; a claim is created, evidence added and status changed only in Airbnb's Resolution Center UI, not via API. Use this for visibility and action tracking (`suggestedActionText`). The money a resolution moved is in the transactions ledger as `Resolution Payout` / `Resolution Adjustment` rows sharing the same reference \u2014 join on `resolutionId`. Cursor-paginated, newest first.",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "description": "Filter by lifecycle: `open` (still needs action) or `closed` (settled). Omit for all.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "open",
+                "closed"
+              ]
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "description": "Page size (default 50, max 200).",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "description": "Opaque pagination cursor from a previous `pagination.nextCursor`.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Resolutions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "data",
+                    "pagination"
+                  ],
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/Resolution"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/Pagination"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      },
+      "post": {
+        "operationId": "refresh_airbnb_resolutions",
+        "summary": "Refresh Airbnb resolutions from Airbnb",
+        "description": "Pulls the latest Resolution Center cases from Airbnb (read-only) and stores them, then read with GET. Optionally scope to one `account_id` and/or `status`.",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "account_id": {
+                    "type": "string",
+                    "description": "Limit the refresh to one Airbnb host id. Omit for all connected accounts."
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "OPEN",
+                      "CLOSED"
+                    ],
+                    "description": "Limit the refresh to one lifecycle. Omit for all."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Refresh outcome.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "synced",
+                    "count",
+                    "accounts"
+                  ],
+                  "properties": {
+                    "synced": {
+                      "type": "boolean"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "description": "Resolutions upserted across all accounts."
+                    },
+                    "accounts": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "account_id",
+                          "count"
+                        ],
+                        "properties": {
+                          "account_id": {
+                            "type": "string"
+                          },
+                          "count": {
+                            "type": "integer"
+                          },
+                          "error": {
+                            "type": "object",
+                            "nullable": true,
+                            "properties": {
+                              "code": {
+                                "type": "string"
+                              },
+                              "message": {
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/channels/airbnb/resolutions/{id}": {
+      "get": {
+        "operationId": "get_airbnb_resolution",
+        "summary": "Get an Airbnb Resolution Center case",
+        "description": "One Airbnb Resolution Center case. `{id}` is the Airbnb resolution id (the `resolutionId` from the list, also a transaction's `reference`). Read-only (see the list endpoint). The amounts moved are in the transactions ledger \u2014 join `resolutionId` to a transaction's `reference`. 404 when it isn't in this workspace (POST the list endpoint to refresh first).",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The Airbnb resolution id.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Resolution",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Resolution"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/connections/{id}/imports": {
+      "get": {
+        "operationId": "listConnectionImports",
+        "summary": "List a connection's imports",
+        "description": "The import runs of one connected account, newest first: the first sync after connecting, a room or unit mapped later, a reconnect, a re-sync. Each run says where it stands (`running`, `completed`, `failed`), its stages and what it imported.\n\nTo know when an account's first sync is done, wait for the `account.import.completed` webhook, or poll this endpoint (or `GET /v1/connect`, whose connections carry their latest `import`) until the newest run is no longer `running`.\n\nAuth: a Repull API key, or a Connect session token (`sessionId`).",
+        "tags": [
+          "Connections"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Connection handle `{provider}:{externalAccountId}`, e.g. `booking_extranet:36`, `vrbo:12`, `airbnb:1234567`, `hostaway:27434` \u2014 the `provider` and `externalAccountId` of a connection on `GET /v1/connect`, or the account of an `account.*` webhook."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 20
+            },
+            "description": "How many runs to return, newest first."
+          },
+          {
+            "name": "sessionId",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The Connect session ID (capability token)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Imports, newest first. Empty when the account has none recorded.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/AccountImport"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/Pagination"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
+    },
+    "/v1/listings/promotions/bulk": {
+      "post": {
+        "operationId": "bulk_listing_promotions",
+        "summary": "Add or remove a promotion on many listings",
+        "description": "Applies one promotion to up to 100 listings \u2014 `add` it, or `remove` the listing's running promotion of that channel and type. Each listing gets its own result with the channel's reason when refused, so one refusal doesn't stop the rest. Returns `403 listing_inactive` before doing anything when any listing is inactive.",
+        "tags": [
+          "Promotions"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionBulkRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A result per listing",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionBulkResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions": {
+      "get": {
+        "operationId": "list_listing_promotions",
+        "summary": "List a listing's promotions",
+        "description": "Airbnb and Booking.com promotions on the listing, in one model. Includes Airbnb promotions running or available (the new listing promotion shows as `eligible` when the listing qualifies), Airbnb Custom promotions seen on bookings (read-only \u2014 they override your prices on Airbnb), and Booking.com promotions covering the listing's room, including deactivated ones.\n\nPass `refresh=true` to re-read the channels first; otherwise the stored copy is returned (kept current by Airbnb's notifications and a sync every 30 minutes).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "refresh",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "description": "Re-read Airbnb and Booking.com before answering."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The listing's promotions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "post": {
+        "operationId": "create_listing_promotion",
+        "summary": "Add a promotion to a listing",
+        "description": "Adds an Airbnb or Booking.com promotion. Read `GET /v1/listings/{id}/promotions/catalog` first for the types and fields the listing's channels accept.\n\n**Airbnb:** send `channel` and `type` only (`top_rated_guests`, `mobile`, `new_listing`) \u2014 Airbnb sets the discount. **Booking.com:** a listing's promotion covers that listing's room; send `discountPercent` and the rules the type takes, and `hotelId` when the listing is on several properties.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionCreateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "The new promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/catalog": {
+      "get": {
+        "operationId": "get_listing_promotion_catalog",
+        "summary": "Promotion types a listing can use",
+        "description": "Per channel: whether the listing is connected, and each promotion type with a short description for hosts, whether it is new, whether it is available to this listing (and why not), and every field \u2014 supported or not \u2014 with its limits and any value the channel fixes. Booking.com's types and limits come from the property itself; seasonal campaigns appear while Booking.com runs them.\n\nAirbnb asks partners to show newly available discounts with a \u201cNew\u201d badge and to grey out fields a discount does not support rather than hide them; `isNew` and `fields` carry what that needs.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The catalog",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCatalogResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/refresh": {
+      "post": {
+        "operationId": "refresh_listing_promotions",
+        "summary": "Re-read a listing's promotions now",
+        "description": "Reads the listing's promotions from Airbnb and Booking.com and returns them. Booking.com promotions belong to the property, so the property's other listings are refreshed too. `errors` lists any channel that could not be read.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The listing's promotions after the read",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionRefreshResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/{promotionId}": {
+      "get": {
+        "operationId": "get_listing_promotion",
+        "summary": "Get one promotion",
+        "description": "One promotion on the listing.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "update_listing_promotion",
+        "summary": "Change a promotion",
+        "description": "Booking.com promotions only \u2014 Airbnb's have nothing to change. `rules`, when sent, replaces the promotion's rules whole. A promotion that also covers other listings' rooms changes for them too, so it needs `confirmShared: true` (otherwise `409 promotion_shared_promotion`). Promotions that come from the listing's weekly or monthly discount are changed in its pricing settings.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionUpdateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The changed promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "delete_listing_promotion",
+        "summary": "Remove a promotion from a listing",
+        "description": "Airbnb: ends the listing's enrolment. Booking.com: takes the listing's room off the promotion \u2014 it keeps running for any other rooms it covers, and is deactivated when none are left. Airbnb Custom promotions can only be ended in Airbnb.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Removed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      }
     }
   }
 }