repull 0.2.35 → 0.2.37

data/openapi/v1.json

@@ -405,6 +405,94 @@
           }
         }
       },
+      "ReservationAccessCode": {
+        "type": "object",
+        "description": "One door code for a stay, as the PMS reported it.",
+        "required": [
+          "code",
+          "type",
+          "status",
+          "validFrom",
+          "validUntil",
+          "locks",
+          "source",
+          "updatedAt"
+        ],
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "The code to enter on the lock.",
+            "example": "482913"
+          },
+          "type": {
+            "type": "string",
+            "description": "`guest`: the code to give the guest. `backup`: give it only if the guest code fails; Guesty may change a backup code read before check-in day.",
+            "example": "guest"
+          },
+          "status": {
+            "type": "string",
+            "nullable": true,
+            "description": "The PMS's status for the code, lower-cased.",
+            "example": "active"
+          },
+          "validFrom": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the code starts working. `null` when the PMS gives no window.",
+            "example": "2026-11-01T20:00:00.000Z"
+          },
+          "validUntil": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the code stops working. `null` when the PMS gives no window.",
+            "example": "2026-11-05T15:00:00.000Z"
+          },
+          "locks": {
+            "type": "array",
+            "description": "The locks the code opens.",
+            "items": {
+              "type": "object",
+              "required": [
+                "id",
+                "name",
+                "provider"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The lock's id in the PMS.",
+                  "example": "64f0c1aa2b3c4d5e6f708192"
+                },
+                "name": {
+                  "type": "string",
+                  "nullable": true,
+                  "example": "Front door"
+                },
+                "provider": {
+                  "type": "string",
+                  "nullable": true,
+                  "description": "The lock brand, as the PMS names it.",
+                  "example": "schlage"
+                }
+              }
+            }
+          },
+          "source": {
+            "type": "string",
+            "description": "The PMS the code was read from.",
+            "example": "guesty"
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the codes were last read from the PMS.",
+            "example": "2026-10-31T14:30:00.000Z"
+          }
+        }
+      },
       "ReservationPrimaryGuest": {
         "type": "object",
         "description": "Inline guest summary resolved by JOIN-ing the `guests` table. Populated for every reservation that has a linked guest row; OMITTED entirely (not null) for owner-blocks / pre-arrival rows / partial-sync gaps. Always optional-chain in SDK consumers.",
@@ -738,6 +826,20 @@
               }
             }
           },
+          "pmsReservationId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The PMS's own id for this reservation (for example Guesty's reservation `_id`), so you can look it up in the PMS. `null` when the reservation did not come from a PMS.",
+            "example": "6a0374cd5eeb88f1381f9ac1"
+          },
+          "accessCodes": {
+            "type": "array",
+            "nullable": true,
+            "items": {
+              "$ref": "#/components/schemas/ReservationAccessCode"
+            },
+            "description": "Door codes for the stay from the PMS's lock manager (today: Guesty Locks Manager), refreshed about every 30 minutes for stays checking in within 14 days that have not checked out. `null` when the reservation's codes are not read from a PMS. `[]` when they are and there is none yet, and for a cancelled stay."
+          },
           "primaryGuest": {
             "allOf": [
               {
@@ -2749,6 +2851,10 @@
           "reservation.alteration.responded",
           "reservation.request.created",
           "reservation.request.updated",
+          "booking.unacknowledged",
+          "channel.sync.failed",
+          "channel.degraded",
+          "reservation.thread.assigned",
           "inquiry.created",
           "inquiry.updated",
           "listing.created",
@@ -3365,6 +3471,20 @@
             "nullable": true,
             "example": "2026-11-11"
           },
+          "guest": {
+            "type": "object",
+            "description": "Who asked. Airbnb shares only the first name before the guest books.",
+            "properties": {
+              "id": {
+                "type": "string",
+                "nullable": true
+              },
+              "firstName": {
+                "type": "string",
+                "nullable": true
+              }
+            }
+          },
           "guests": {
             "type": "object",
             "properties": {
@@ -3620,6 +3740,15 @@
                   "type": "string",
                   "nullable": true,
                   "example": "sync_all"
+                },
+                "account": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/RecordAccount"
+                    }
+                  ],
+                  "nullable": true,
+                  "description": "The connected account this listing belongs to on this channel \u2014 for Airbnb the host account (`externalAccountId` is the Airbnb host id). The same account `account.disconnected` names, so a disconnect can be matched to its listings. Null when it cannot be resolved."
                 }
               }
             }
@@ -3889,6 +4018,24 @@
             "type": "string",
             "example": "refresh_token_rejected",
             "description": "Why the connection was lost. `refresh_token_rejected` \u2014 upstream OAuth refresh endpoint returned a hard rejection. `manual_disconnect` \u2014 host/admin disconnected via the dashboard. `auth_expired` \u2014 credentials aged out without ever being used. `revoked_upstream` \u2014 provider notified us the user revoked access."
+          },
+          "listings": {
+            "type": "array",
+            "description": "The listings this account holds in your workspace \u2014 the ones that stop syncing until it is reconnected. Identity only; inactive listings included. Matches `channels[].account` on `GET /v1/listings`. Empty when the account has no listings here.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "example": 4118
+                },
+                "name": {
+                  "type": "string",
+                  "nullable": true,
+                  "example": "Ocean View Villa"
+                }
+              }
+            }
           }
         }
       },
@@ -4618,7 +4765,103 @@
           }
         }
       },
-      "InquiryCreatedEvent": {
+      "ChannelSyncFailurePayload": {
+        "type": "object",
+        "description": "Payload for `channel.sync.failed`. A push of availability, rates or content to a connected channel did not land.",
+        "required": [
+          "object",
+          "failures"
+        ],
+        "properties": {
+          "object": {
+            "type": "object",
+            "required": [
+              "listingId",
+              "customerId",
+              "operation",
+              "total"
+            ],
+            "properties": {
+              "listingId": {
+                "type": "integer"
+              },
+              "customerId": {
+                "type": "integer"
+              },
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "availability",
+                  "rate",
+                  "restriction",
+                  "content",
+                  "reservation"
+                ],
+                "description": "Which wire failed. A refused rate and a closed connection call for different responses."
+              },
+              "total": {
+                "type": "boolean",
+                "description": "true when NO mapping accepted the push. false means some did \u2014 the more dangerous case, because the listing is live somewhere and inconsistent."
+              },
+              "from": {
+                "type": "string",
+                "format": "date",
+                "nullable": true,
+                "description": "Start of the date range the push covered, when the operation is date-scoped."
+              },
+              "to": {
+                "type": "string",
+                "format": "date",
+                "nullable": true
+              }
+            }
+          },
+          "failures": {
+            "type": "array",
+            "description": "One entry per channel mapping that refused the push.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "channel": {
+                  "type": "string",
+                  "example": "airbnb"
+                },
+                "externalListingId": {
+                  "type": "string",
+                  "nullable": true,
+                  "description": "The channel's own id for the room or listing."
+                },
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "rejected",
+                    "auth",
+                    "not_mapped",
+                    "unreachable",
+                    "unknown"
+                  ],
+                  "description": "`unknown` means we could not classify it \u2014 never that the channel refused."
+                },
+                "message": {
+                  "type": "string",
+                  "nullable": true,
+                  "description": "The channel's own message, verbatim."
+                }
+              }
+            }
+          },
+          "reservationId": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Set when the push was blocking dates for a booking just taken. Those nights are sold on one channel and still open on another \u2014 treat as urgent."
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "ChannelSyncFailedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -4643,18 +4886,64 @@
           },
           "timestamp": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+            "format": "date-time"
           },
           "account": {
             "$ref": "#/components/schemas/WebhookEventAccount"
           },
           "data": {
-            "$ref": "#/components/schemas/InquiryCreatedPayload"
+            "$ref": "#/components/schemas/ChannelSyncFailurePayload"
           }
         }
       },
-      "InquiryUpdatedEvent": {
+      "ChannelDegradedPayload": {
+        "type": "object",
+        "description": "Payload for `channel.degraded`. A connection is failing repeatedly and will stop working. Sent on the transition into degraded or down, not on every health check.",
+        "required": [
+          "object"
+        ],
+        "properties": {
+          "object": {
+            "type": "object",
+            "required": [
+              "customerId",
+              "provider",
+              "status"
+            ],
+            "properties": {
+              "customerId": {
+                "type": "integer"
+              },
+              "provider": {
+                "type": "string",
+                "example": "booking"
+              },
+              "externalAccountId": {
+                "type": "string",
+                "nullable": true,
+                "description": "The provider's own account, host or hotel id."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "degraded",
+                  "down"
+                ]
+              },
+              "detail": {
+                "type": "string",
+                "nullable": true,
+                "description": "What we observed, in the provider's words where possible. A bare \"degraded\" tells nobody what to fix."
+              }
+            }
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "ChannelDegradedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -4670,8 +4959,7 @@
           },
           "eventId": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "uuid"
           },
           "apiVersion": {
             "type": "string",
@@ -4679,18 +4967,64 @@
           },
           "timestamp": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+            "format": "date-time"
           },
           "account": {
             "$ref": "#/components/schemas/WebhookEventAccount"
           },
           "data": {
-            "$ref": "#/components/schemas/InquiryUpdatedPayload"
+            "$ref": "#/components/schemas/ChannelDegradedPayload"
           }
         }
       },
-      "ListingCreatedEvent": {
+      "ReservationThreadAssignedPayload": {
+        "type": "object",
+        "description": "Payload for `reservation.thread.assigned`. A message thread was attached to a booking. Threads are often born orphaned \u2014 a guest messages about a booking whose import has not landed \u2014 and adopted when the reservation arrives.",
+        "required": [
+          "object"
+        ],
+        "properties": {
+          "object": {
+            "type": "object",
+            "required": [
+              "reservationId",
+              "customerId",
+              "threadId"
+            ],
+            "properties": {
+              "reservationId": {
+                "type": "integer"
+              },
+              "customerId": {
+                "type": "integer"
+              },
+              "listingId": {
+                "type": "integer",
+                "nullable": true
+              },
+              "threadId": {
+                "type": "string",
+                "description": "Repull conversation id."
+              },
+              "externalThreadId": {
+                "type": "string",
+                "nullable": true,
+                "description": "The channel's own conversation id."
+              },
+              "previousReservationId": {
+                "type": "integer",
+                "nullable": true,
+                "description": "What the thread pointed at before. Null on the common orphan-adoption case; set when a thread moved between bookings."
+              }
+            }
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "ReservationThreadAssignedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -4706,8 +5040,7 @@
           },
           "eventId": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "uuid"
           },
           "apiVersion": {
             "type": "string",
@@ -4715,18 +5048,189 @@
           },
           "timestamp": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+            "format": "date-time"
           },
           "account": {
             "$ref": "#/components/schemas/WebhookEventAccount"
           },
           "data": {
-            "$ref": "#/components/schemas/ListingCreatedPayload"
+            "$ref": "#/components/schemas/ReservationThreadAssignedPayload"
           }
         }
       },
-      "ListingUpdatedEvent": {
+      "BookingUnacknowledgedPayload": {
+        "type": "object",
+        "description": "Payload for `booking.unacknowledged`. A booking changed and your system has not acknowledged the change through the revision feed. Sent once per outstanding revision \u2014 not once per check \u2014 so a booking that keeps waiting does not keep alerting. A booking that changes AGAIN mints a new revision and does alert again, because that is a new thing to acknowledge. Acknowledging the revision stops it.",
+        "required": [
+          "object",
+          "revisionId",
+          "outstandingSince"
+        ],
+        "properties": {
+          "object": {
+            "$ref": "#/components/schemas/ReservationWebhookObject"
+          },
+          "revisionId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The outstanding revision. Acknowledge this to stop the alert."
+          },
+          "outstandingSince": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When the booking actually changed \u2014 NOT when we noticed. Revisions are minted when you first poll the feed, so a mint timestamp would measure how recently you looked rather than how long the booking has waited."
+          },
+          "outstandingHours": {
+            "type": "integer",
+            "description": "Whole hours since `outstandingSince`, for convenience."
+          }
+        }
+      },
+      "BookingUnacknowledgedEvent": {
+        "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/BookingUnacknowledgedPayload"
+          }
+        }
+      },
+      "InquiryCreatedEvent": {
+        "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/InquiryCreatedPayload"
+          }
+        }
+      },
+      "InquiryUpdatedEvent": {
+        "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/InquiryUpdatedPayload"
+          }
+        }
+      },
+      "ListingCreatedEvent": {
+        "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/ListingCreatedPayload"
+          }
+        }
+      },
+      "ListingUpdatedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -5741,6 +6245,18 @@
           {
             "$ref": "#/components/schemas/ReservationRequestUpdatedEvent"
           },
+          {
+            "$ref": "#/components/schemas/BookingUnacknowledgedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/ChannelSyncFailedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/ChannelDegradedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/ReservationThreadAssignedEvent"
+          },
           {
             "$ref": "#/components/schemas/InquiryCreatedEvent"
           },
@@ -5827,6 +6343,10 @@
             "reservation.alteration.responded": "#/components/schemas/ReservationAlterationRespondedEvent",
             "reservation.request.created": "#/components/schemas/ReservationRequestCreatedEvent",
             "reservation.request.updated": "#/components/schemas/ReservationRequestUpdatedEvent",
+            "booking.unacknowledged": "#/components/schemas/BookingUnacknowledgedEvent",
+            "channel.sync.failed": "#/components/schemas/ChannelSyncFailedEvent",
+            "channel.degraded": "#/components/schemas/ChannelDegradedEvent",
+            "reservation.thread.assigned": "#/components/schemas/ReservationThreadAssignedEvent",
             "inquiry.created": "#/components/schemas/InquiryCreatedEvent",
             "inquiry.updated": "#/components/schemas/InquiryUpdatedEvent",
             "listing.created": "#/components/schemas/ListingCreatedEvent",
@@ -9384,6 +9904,15 @@
           },
           "syncEnabled": {
             "type": "boolean"
+          },
+          "account": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RecordAccount"
+              }
+            ],
+            "nullable": true,
+            "description": "The connected account this listing belongs to on this channel \u2014 for Airbnb the host account (`externalAccountId` is the Airbnb host id). The same account `account.disconnected` names, so a disconnect can be matched to its listings. Null when it cannot be resolved."
           }
         }
       },
@@ -9416,6 +9945,341 @@
           "isPresent"
         ]
       },
+      "ChargePer": {
+        "type": "string",
+        "enum": [
+          "stay",
+          "night",
+          "guest",
+          "guest_night"
+        ],
+        "description": "How often an amount is charged: once per stay, per night, per guest, or per guest per night."
+      },
+      "ListingRoom": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Room kind, Airbnb spelling: `bedroom`, `living_room`, `full_bathroom`, `kitchen`, \u2026",
+            "example": "bedroom"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "number": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Position among rooms of the same type (bedroom 1, 2, \u2026)."
+          },
+          "isPrivate": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "beds": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "example": "queen_bed"
+                },
+                "quantity": {
+                  "type": "integer",
+                  "example": 1
+                }
+              }
+            }
+          }
+        }
+      },
+      "ListingPolicies": {
+        "type": "object",
+        "properties": {
+          "cancellationPolicy": {
+            "type": "string",
+            "nullable": true,
+            "example": "flexible"
+          },
+          "houseRules": {
+            "type": "string",
+            "nullable": true
+          },
+          "checkIn": {
+            "type": "object",
+            "properties": {
+              "method": {
+                "type": "string",
+                "nullable": true,
+                "description": "`lockbox`, `smartlock`, `keypad`, `doorman`, `host_greets`, `building_staff`, `other`.",
+                "example": "lockbox"
+              },
+              "instructions": {
+                "type": "string",
+                "nullable": true
+              },
+              "from": {
+                "type": "string",
+                "nullable": true,
+                "example": "15:00"
+              },
+              "until": {
+                "type": "string",
+                "nullable": true,
+                "example": "22:00"
+              }
+            }
+          },
+          "checkOut": {
+            "type": "object",
+            "properties": {
+              "until": {
+                "type": "string",
+                "nullable": true,
+                "example": "11:00"
+              }
+            }
+          },
+          "allowsPets": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "allowsSmoking": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "allowsEvents": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "allowsChildren": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "allowsInfants": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "childrenMinAge": {
+            "type": "integer",
+            "nullable": true
+          },
+          "quietHours": {
+            "type": "object",
+            "nullable": true,
+            "properties": {
+              "start": {
+                "type": "string",
+                "example": "22:00"
+              },
+              "end": {
+                "type": "string",
+                "example": "07:00"
+              }
+            }
+          },
+          "securityDeposit": {
+            "type": "number",
+            "nullable": true,
+            "description": "In the listing currency."
+          }
+        }
+      },
+      "ListingRules": {
+        "type": "object",
+        "properties": {
+          "minNights": {
+            "type": "integer",
+            "nullable": true
+          },
+          "maxNights": {
+            "type": "integer",
+            "nullable": true
+          },
+          "bookingWindowDays": {
+            "type": "integer",
+            "nullable": true,
+            "description": "How far ahead a guest can book. `null` when unlimited or not set."
+          },
+          "advanceNoticeHours": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Hours of notice required before check-in."
+          },
+          "preparationDays": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Nights blocked between stays."
+          },
+          "allowsBookingRequests": {
+            "type": "boolean",
+            "nullable": true,
+            "description": "Whether guests may send a booking request inside the notice window."
+          },
+          "instantBook": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "ListingPricingSettings": {
+        "type": "object",
+        "description": "The listing's standing prices. Nightly rates per date are on `GET /v1/availability/{propertyId}`.",
+        "properties": {
+          "currency": {
+            "type": "string",
+            "nullable": true,
+            "example": "GBP"
+          },
+          "basePrice": {
+            "type": "number",
+            "nullable": true,
+            "description": "Default nightly rate."
+          },
+          "weekendPrice": {
+            "type": "number",
+            "nullable": true
+          },
+          "cleaningFee": {
+            "type": "number",
+            "nullable": true
+          },
+          "extraGuestFee": {
+            "type": "number",
+            "nullable": true,
+            "description": "Per extra guest per night, above `guestsIncluded`."
+          },
+          "guestsIncluded": {
+            "type": "integer",
+            "nullable": true
+          },
+          "securityDeposit": {
+            "type": "number",
+            "nullable": true
+          },
+          "weeklyDiscountPercent": {
+            "type": "number",
+            "nullable": true,
+            "description": "Percent off for 7+ nights: `10` is 10%."
+          },
+          "monthlyDiscountPercent": {
+            "type": "number",
+            "nullable": true,
+            "description": "Percent off for 28+ nights."
+          }
+        }
+      },
+      "ListingFee": {
+        "type": "object",
+        "description": "A fee on top of the nightly rate, the cleaning fee included. One shape for every channel and PMS.",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "`cleaning`, `pet`, `linen`, `resort`, `management`, `community`, or the source's own kind.",
+            "example": "cleaning"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true,
+            "example": "Damage Waiver"
+          },
+          "amount": {
+            "type": "number",
+            "description": "In the listing currency when `amountType` is `flat`; a percent when `percent`.",
+            "example": 35
+          },
+          "amountType": {
+            "type": "string"
+          },
+          "chargedPer": {
+            "$ref": "#/components/schemas/ChargePer"
+          },
+          "optional": {
+            "type": "boolean",
+            "description": "Offered to the guest (an add-on) rather than always charged."
+          },
+          "source": {
+            "type": "string",
+            "description": "Where it was read from: `airbnb`, `guesty`, \u2026",
+            "example": "guesty"
+          }
+        }
+      },
+      "ListingTax": {
+        "type": "object",
+        "description": "A tax charged to the guest. One shape for every channel and PMS.",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "`vat`, `vat_gst`, `city_tax`, `transient_occupancy_tax`, \u2026",
+            "example": "vat"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true,
+            "example": "VAT"
+          },
+          "amount": {
+            "type": "number",
+            "example": 20
+          },
+          "amountType": {
+            "type": "string"
+          },
+          "chargedPer": {
+            "$ref": "#/components/schemas/ChargePer"
+          },
+          "appliesTo": {
+            "type": "array",
+            "nullable": true,
+            "items": {
+              "type": "string"
+            },
+            "description": "What it is charged on (`accommodation`, `cleaning`, other fee types). `null`: the whole stay."
+          },
+          "included": {
+            "type": "boolean",
+            "description": "Already included in the price rather than added on top."
+          },
+          "source": {
+            "type": "string",
+            "description": "`airbnb` (host-remitted), `airbnb_collected` (Airbnb collects and remits), `guesty`, \u2026"
+          }
+        }
+      },
+      "ListingContentPhoto": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "thumbnailUrl": {
+            "type": "string",
+            "nullable": true
+          },
+          "caption": {
+            "type": "string",
+            "nullable": true
+          },
+          "category": {
+            "type": "string",
+            "nullable": true
+          },
+          "width": {
+            "type": "integer",
+            "nullable": true
+          },
+          "height": {
+            "type": "integer",
+            "nullable": true
+          },
+          "sortOrder": {
+            "type": "integer"
+          }
+        }
+      },
       "Listing": {
         "type": "object",
         "description": "A vacation rental listing in your Repull workspace.\n\nAn **inactive** listing appears only in `GET /v1/listings`, and only when `?status=` asks for it. Such a row carries identity fields only \u2014 `id`, `name`, `status`, `inactiveReason`, `address.city`, `channels` \u2014 so the street, `content`, `details`, `createdAt` and `updatedAt` are absent until the listing is activated. `inactiveReason` is `plan_limit` (held back by the plan; activating needs a free slot or an upgrade), `unlisted_on_airbnb`, or `deactivated` (switched off by you). `GET /v1/listings/{id}` and every other listing endpoint answer `403 listing_inactive` for it. The one field you can add back is `thumbnailUrl`, by passing `?include=thumbnail` \u2014 enough to render an activate/deactivate picker with pictures from a single request.",
@@ -9600,6 +10464,61 @@
             "nullable": true,
             "description": "**Only present when the caller passes `?include=details`.** Sourced from `listings_details`. `null` when the listing has no details row stored (vs the field being absent \u2014 that signals the caller did not opt into the expansion)."
           },
+          "rooms": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ListingRoom"
+            },
+            "description": "**Only present with `?include=rooms`.** Each room and its beds. `[]` when none are stored."
+          },
+          "policies": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ListingPolicies"
+              }
+            ],
+            "nullable": true,
+            "description": "**Only present with `?include=policies`.** Cancellation, house rules, check-in and check-out, pets/smoking/events/children, quiet hours, deposit."
+          },
+          "rules": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ListingRules"
+              }
+            ],
+            "nullable": true,
+            "description": "**Only present with `?include=rules`.** Stay rules: min/max nights, booking window, advance notice, preparation time, and whether booking requests are allowed."
+          },
+          "pricing": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ListingPricingSettings"
+              }
+            ],
+            "nullable": true,
+            "description": "**Only present with `?include=pricing`.** Standing prices: base and weekend rate, cleaning and extra-guest fees, deposit, weekly/monthly discounts. `null` when none are stored."
+          },
+          "fees": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ListingFee"
+            },
+            "description": "**Only present with `?include=fees`.** Every fee, the cleaning fee included, whatever channel or PMS it came from. `[]` when none."
+          },
+          "taxes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ListingTax"
+            },
+            "description": "**Only present with `?include=taxes`.** Taxes charged to the guest. `[]` when none."
+          },
+          "photos": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ListingContentPhoto"
+            },
+            "description": "**Only present with `?include=photos`.** The listing photos in display order."
+          },
           "createdAt": {
             "type": "string",
             "format": "date-time"
@@ -11736,17 +12655,17 @@
           },
           "min_nights": {
             "type": "integer",
-            "minimum": 1,
+            "minimum": -1,
             "maximum": 1125,
             "nullable": true,
-            "description": "Minimum length of stay for the date(s)."
+            "description": "Minimum length of stay for the date(s), 1\u20131125. Send `-1` to drop the date's own minimum so it follows the listing default again (`default_min_nights`). `0` and `null` do not clear it."
           },
           "max_nights": {
             "type": "integer",
-            "minimum": 1,
+            "minimum": -1,
             "maximum": 1125,
             "nullable": true,
-            "description": "Maximum length of stay for the date(s); no lower than `min_nights`."
+            "description": "Maximum length of stay for the date(s), 1\u20131125 and no lower than `min_nights`. Send `-1` to drop the date's own maximum so it follows the listing default again (`default_max_nights`)."
           },
           "closed_to_arrival": {
             "type": "boolean",
@@ -16232,7 +17151,7 @@
       "post": {
         "operationId": "create_reservation",
         "summary": "Create a reservation",
-        "description": "Creates a reservation \u2014 in the listing's PMS when it has one, otherwise as a direct booking in Repull.\n\n### Where the booking is made\n\n- **A listing managed in a connected PMS** (Mews, Cloudbeds, Hostaway, Guesty, Beds24, BookingSync, Lodgify, Smoobu, Hospitable, iGMS, OwnerRez, Track): the booking is created **in the PMS first**, then recorded in Repull from the PMS's own record, so the next sync lands on the same confirmation code and nothing is duplicated. A booking is **never** created only in Repull for such a listing \u2014 the PMS would keep selling the dates. What the PMS cannot do is refused (`422 pms_write_unsupported`), never faked. The PMS checks availability: taken dates answer `409 pms_unavailable`.\n- **Any other listing**: a direct booking made in Repull, with everything that hangs off one \u2014 the guest, the conversation, the calendar block and the `reservation.created` fan-out that issues the door code and starts the messaging automations. Priced by the listing's own rates; **availability is NOT checked** (call `GET /v1/availability/{propertyId}` first if that matters).\n\n`GET /v1/listings/{id}` \u2192 `capabilities.reservations` says which applies to a listing and exactly what it supports (`create`, `modify`, `cancel`, `quote`, `customPrice`, plus `notes`).\n\n### Fields by listing kind\n\n| Field | PMS listing | Direct-booking listing |\n|---|---|---|\n| `listingId`, `checkIn`, `checkOut`, `guest`, `guestCount`, `adults`, `children` | \u2713 | \u2713 |\n| `status` | `confirmed` (default) or `tentative` | \u2713 |\n| `totalPrice` | \u2713 where `capabilities.reservations.customPrice`; otherwise the PMS prices the stay | `422 unsupported_field` (priced from the listing's rates) |\n| `notes`, `unitId`, `sendConfirmationEmail` | \u2713 | `422 unsupported_field` |\n| `checkInTime`, `checkOutTime`, `currency`, `guestId` | `422 unsupported_field` (the PMS's own settings apply) | \u2713 |\n| `platform` | `direct` or `website` (`owner` \u2192 `422 pms_write_unsupported`; block owner stays in the PMS) | `direct`, `website` or `owner` |\n\nA field a listing cannot take is refused by name, never silently dropped. `platform` never accepts `airbnb` / `booking` / `vrbo`: those reservations are owned by the channel and arrive through sync.\n\n### Per-PMS limits\n\n| PMS | create | change | cancel | quote | `totalPrice` | Limits |\n|---|---|---|---|---|---|---|\n| Mews | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 | \u2014 |\n| Cloudbeds | \u2713 | \u2713 | \u2713 | \u2013 | \u2013 | Books at the rate plan's price; group bookings supported. |\n| Hostaway | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Direct-channel bookings only; a specific unit is refused; a date change keeps the booked total. |\n| Guesty | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Cancels direct and Vrbo bookings; other channel bookings are cancelled on the channel. |\n| Beds24 | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs the `write:bookings` scope; a multi-room property needs `unitId`. |\n| BookingSync | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs `bookings_write`; fees and taxes are not itemized; no guest email. |\n| Lodgify | \u2713 | \u2713 | \u2713 (declines) | \u2713 | \u2713 | Cancel declines the booking; single-room bookings. |\n| Smoobu | \u2713 | \u2713 (no dates) | \u2713 | \u2713 | \u2713 | Dates cannot be changed through Smoobu's API \u2014 cancel and rebook, or change them in Smoobu. |\n| Hospitable | \u2713 | \u2713 | \u2713 | \u2713 (Direct plan) | \u2713 | Manual reservations only; needs `reservation:write`; adds no fees or taxes. |\n| iGMS | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 (required) | iGMS direct bookings only; a price is required; no tentative holds. |\n| OwnerRez | \u2713 | \u2713 | \u2013 | \u2713 | \u2013 | No cancel through OwnerRez's API; priced by the property's own rates; needs the `full` scope. |\n| Track | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Track decides Hold vs Confirmed from the property's channel mode; a set price on a Channel Key needs \"Allow Custom Pricing\"; a unit change needs `moveReasonId` on the connection; a date change re-prices at Track's current rates. |\n\nEvery PMS except Cloudbeds refuses group bookings, and every vacation-rental PMS refuses to change or cancel a booking that came from a channel (Airbnb, Booking.com, Vrbo\u2026) \u2014 that is done on the channel.\n\n**Verification.** Mews and Cloudbeds were run end to end on their vendors' sandboxes. Every other PMS is **verified against the vendor's API documentation only** \u2014 no live account has been written to yet. `capabilities.reservations.verifiedAgainst` says which.\n\n### Idempotency\n\n**Send `Idempotency-Key`.** A network timeout here is exactly the case it exists for. The key is also sent to the PMS as the booking's reference, so even a retry that reaches the PMS again finds the booking instead of making a second one (`409 pms_duplicate` with `existing`, or the existing booking returned). A completed answer is replayed with `Idempotency-Status: cached` and the PMS is not called again. `502 pms_error` (the PMS could not be reached) is NOT stored \u2014 retry with the same key. `502 reservation_created_in_pms_only` IS stored, unlike every other 5xx: the booking exists in the PMS and arrives with the next sync, so a retry replays that answer rather than booking twice.\n\n### Partial success\n\nWhen the PMS created the booking but a follow-up step did not apply (for example the notes, or a tentative state), the response is still `201`, with `pms.partial: true` and the steps in `pms.failedSections`. The booking exists \u2014 do not create it again.\n\n`X-Account-Id` restricts the listing to one connected account. Returns `403 listing_inactive` when the listing is inactive.",
+        "description": "Creates a reservation \u2014 in the listing's PMS when it has one, otherwise as a direct booking in Repull.\n\n### Where the booking is made\n\n- **A listing managed in a connected PMS** (Mews, Cloudbeds, Hostaway, Guesty, Beds24, BookingSync, Lodgify, Smoobu, Hospitable, iGMS, OwnerRez, Track, CiiRUS): the booking is created **in the PMS first**, then recorded in Repull from the PMS's own record, so the next sync lands on the same confirmation code and nothing is duplicated. A booking is **never** created only in Repull for such a listing \u2014 the PMS would keep selling the dates. What the PMS cannot do is refused (`422 pms_write_unsupported`), never faked. The PMS checks availability: taken dates answer `409 pms_unavailable`.\n- **Any other listing**: a direct booking made in Repull, with everything that hangs off one \u2014 the guest, the conversation, the calendar block and the `reservation.created` fan-out that issues the door code and starts the messaging automations. Priced by the listing's own rates; **availability is NOT checked** (call `GET /v1/availability/{propertyId}` first if that matters).\n\n`GET /v1/listings/{id}` \u2192 `capabilities.reservations` says which applies to a listing and exactly what it supports (`create`, `modify`, `cancel`, `quote`, `customPrice`, plus `notes`).\n\n### Fields by listing kind\n\n| Field | PMS listing | Direct-booking listing |\n|---|---|---|\n| `listingId`, `checkIn`, `checkOut`, `guest`, `guestCount`, `adults`, `children` | \u2713 | \u2713 |\n| `status` | `confirmed` (default) or `tentative` | \u2713 |\n| `totalPrice` | \u2713 where `capabilities.reservations.customPrice`; otherwise the PMS prices the stay | `422 unsupported_field` (priced from the listing's rates) |\n| `notes`, `unitId`, `sendConfirmationEmail` | \u2713 | `422 unsupported_field` |\n| `checkInTime`, `checkOutTime`, `currency`, `guestId` | `422 unsupported_field` (the PMS's own settings apply) | \u2713 |\n| `platform` | `direct` or `website` (`owner` \u2192 `422 pms_write_unsupported`; block owner stays in the PMS) | `direct`, `website` or `owner` |\n\nA field a listing cannot take is refused by name, never silently dropped. `platform` never accepts `airbnb` / `booking` / `vrbo`: those reservations are owned by the channel and arrive through sync.\n\n### Per-PMS limits\n\n| PMS | create | change | cancel | quote | `totalPrice` | Limits |\n|---|---|---|---|---|---|---|\n| Mews | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 | \u2014 |\n| Cloudbeds | \u2713 | \u2713 | \u2713 | \u2013 | \u2013 | Books at the rate plan's price; group bookings supported. |\n| Hostaway | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Direct-channel bookings only; a specific unit is refused; a date change keeps the booked total. |\n| Guesty | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Cancels direct and Vrbo bookings; other channel bookings are cancelled on the channel. |\n| Beds24 | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs the `write:bookings` scope; a multi-room property needs `unitId`. |\n| BookingSync | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs `bookings_write`; fees and taxes are not itemized; no guest email. |\n| Lodgify | \u2713 | \u2713 | \u2713 (declines) | \u2713 | \u2713 | Cancel declines the booking; single-room bookings. |\n| Smoobu | \u2713 | \u2713 (no dates) | \u2713 | \u2713 | \u2713 | Dates cannot be changed through Smoobu's API \u2014 cancel and rebook, or change them in Smoobu. |\n| Hospitable | \u2713 | \u2713 | \u2713 | \u2713 (Direct plan) | \u2713 | Manual reservations only; needs `reservation:write`; adds no fees or taxes. |\n| iGMS | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 (required) | iGMS direct bookings only; a price is required; no tentative holds. |\n| OwnerRez | \u2713 | \u2713 | \u2013 | \u2713 | \u2013 | No cancel through OwnerRez's API; priced by the property's own rates; needs the `full` scope. |\n| Track | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Track decides Hold vs Confirmed from the property's channel mode; a set price on a Channel Key needs \"Allow Custom Pricing\"; a unit change needs `moveReasonId` on the connection; a date change re-prices at Track's current rates. |\n| CiiRUS | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | A set price is the rent, with CiiRUS adding its taxes; no tentative holds. |\n\nEvery PMS except Cloudbeds refuses group bookings, and every vacation-rental PMS refuses to change or cancel a booking that came from a channel (Airbnb, Booking.com, Vrbo\u2026) \u2014 that is done on the channel.\n\n**Verification.** Mews and Cloudbeds were run end to end on their vendors' sandboxes. Every other PMS is **verified against the vendor's API documentation only** \u2014 no live account has been written to yet. `capabilities.reservations.verifiedAgainst` says which.\n\n### Idempotency\n\n**Send `Idempotency-Key`.** A network timeout here is exactly the case it exists for. The key is also sent to the PMS as the booking's reference, so even a retry that reaches the PMS again finds the booking instead of making a second one (`409 pms_duplicate` with `existing`, or the existing booking returned). A completed answer is replayed with `Idempotency-Status: cached` and the PMS is not called again. `502 pms_error` (the PMS could not be reached) is NOT stored \u2014 retry with the same key. `502 reservation_created_in_pms_only` IS stored, unlike every other 5xx: the booking exists in the PMS and arrives with the next sync, so a retry replays that answer rather than booking twice.\n\n### Partial success\n\nWhen the PMS created the booking but a follow-up step did not apply (for example the notes, or a tentative state), the response is still `201`, with `pms.partial: true` and the steps in `pms.failedSections`. The booking exists \u2014 do not create it again.\n\n`X-Account-Id` restricts the listing to one connected account. Returns `403 listing_inactive` when the listing is inactive.",
         "tags": [
           "Reservations"
         ],
@@ -17439,7 +18358,7 @@
       "get": {
         "operationId": "getConversation",
         "summary": "Get conversation detail",
-        "description": "Returns one thread (the same shape as the list-row `Conversation`) plus expanded `host` (from `airbnb_hosts` for the thread's `host_id`) and `guest` (resolved via the thread's `reservation_id`, with up to 50 contacts) blocks.\n\nA conversation that belongs to an inactive listing (by the thread's listing or its reservation's listing) returns `403 listing_inactive`. Inactive listings keep syncing; activate the listing to use it here.",
+        "description": "Returns one thread (the same shape as the list-row `Conversation`) plus expanded `host` (from `airbnb_hosts` for the thread's `host_id`) and `guest` (resolved via the thread's `reservation_id`, with up to 50 contacts) blocks. On an inquiry (no reservation yet) `guest` carries the first name Airbnb shares with the inquiry; contacts such as the phone number arrive once the guest books.\n\nA conversation that belongs to an inactive listing (by the thread's listing or its reservation's listing) returns `403 listing_inactive`. Inactive listings keep syncing; activate the listing to use it here.",
         "tags": [
           "Conversations"
         ],
@@ -18277,7 +19196,7 @@
                       "api"
                     ],
                     "default": "hosted",
-                    "description": "Where the channel's units get linked to listings. `hosted` (default): after a Vrbo or Booking.com Extranet sign-in, Connect shows a mapping step and returns to `redirectUrl` when it's confirmed. `api`: Connect skips that step and finishes right after sign-in. The connection reaches you in the `connect.session.completed` webhook (and as `connectionId` in the popup message), its handle is `vrbo:{connectionId}` or `booking_extranet:{connectionId}`; you list the units with `GET /v1/connections/{id}/units` and link them with `POST /v1/connections/{id}/mappings`. Nothing is imported until you post the mappings. Other providers ignore it."
+                    "description": "Where the channel's units get linked to listings. `hosted` (default): after a Vrbo or Booking.com Extranet sign-in, Connect shows a mapping step and returns to `redirectUrl` when it's confirmed. `api`: Connect skips that step and finishes right after sign-in. The connection reaches you in the `connect.session.completed` webhook as `account.externalAccountId` (its `connectionId` is null for these two), and as `connectionId` in the popup message and `accountId` on the redirect, all the same id; its handle is `vrbo:{id}` or `booking_extranet:{id}`; you list the units with `GET /v1/connections/{id}/units` and link them with `POST /v1/connections/{id}/mappings`. Nothing is imported until you post the mappings. Other providers ignore it."
                   },
                   "accessType": {
                     "type": "string",
@@ -18304,7 +19223,7 @@
                   "locale": {
                     "type": "string",
                     "nullable": true,
-                    "description": "Optional UI language for the hosted Connect pages. Accepts any supported locale code (currently `en`, `fr`). When set it pins the language for the whole flow, overriding the workspace `default_language`. Unknown codes are ignored and the page falls back to the workspace default, then `Accept-Language`, then `en`. The end user can still override per-visit with a `?locale=` query param on the hosted page.",
+                    "description": "Optional UI language for the hosted Connect pages. Accepts any supported locale code (currently `en`, `fr`, `de`, `es`, `it`, `nl`). When set it pins the language for the whole flow, overriding the workspace `default_language`. Unknown codes are ignored and the page falls back to the workspace default, then `Accept-Language`, then `en`. The end user can still override per-visit with a `?locale=` query param on the hosted page.",
                     "example": "fr"
                   },
                   "purpose": {
@@ -18562,7 +19481,7 @@
                   "locale": {
                     "type": "string",
                     "nullable": true,
-                    "description": "Airbnb only \u2014 optional UI language for the hosted Connect pages. Accepts any supported locale code (currently `en`, `fr`); unknown codes are ignored and resolution falls back to the workspace `default_language`, then `Accept-Language`, then `en`.",
+                    "description": "Airbnb and Booking.com \u2014 optional UI language for the hosted Connect pages. Accepts any supported locale code (currently `en`, `fr`, `de`, `es`, `it`, `nl`); unknown codes are ignored and resolution falls back to the workspace `default_language`, then `Accept-Language`, then `en`.",
                     "example": "fr"
                   }
                 }
@@ -18586,7 +19505,7 @@
       "delete": {
         "operationId": "delete_connection",
         "summary": "Disconnect provider",
-        "description": "Disconnect ONE connected account of a provider from this workspace. Supported for `airbnb` and `booking`.\n\n**Which account.** Pass `accountId` \u2014 for Airbnb the host id (`accounts[].externalAccountId` from `GET /v1/connect/airbnb`), for Booking.com the hotel id. It is optional only when the workspace has exactly one account for the provider. With several and no `accountId`, the call returns `422` with the account ids in `valid_values` instead of guessing. An `accountId` that is not connected to this workspace returns `404`. Disconnecting one account leaves the others connected.\n\n**What happens.** The account's stored authorization is removed and it stops syncing. Its listings are **deactivated**, not deleted: they stop counting toward your plan's listing limit, their data is kept, and they are returned in `listingsDeactivated`. A listing that is still connected through another account or channel stays active. Reconnect the account, then activate the listings with `POST /v1/listings/status`.\n\nThe change is all or nothing. For Airbnb, the host can also revoke access on Airbnb's side (Account \u2192 Privacy & sharing \u2192 Connected apps); that alone does not update this workspace, so call this endpoint as well.\n\nOther providers return `501 not_implemented` with instructions for disconnecting on the provider's side. That answer depends only on the provider, not on your workspace: an unsupported provider returns `501` whether or not you have a connection to it. `404 not_found` on a supported provider means this workspace has no connection to it (or, with `accountId`, that the account is not connected here).",
+        "description": "Disconnect ONE connected account of a provider from this workspace. Supported for `airbnb`, `booking`, `vrbo-login` and every PMS (`guesty`, `hostaway`, `hospitable`, \u2026).\n\n**Which account.** Pass `accountId` \u2014 for Airbnb the host id (`accounts[].externalAccountId` from `GET /v1/connect/airbnb`), for Booking.com the hotel id, for `vrbo-login` the sign-in's `accounts[].externalAccountId` from `GET /v1/connect/vrbo-login`. It is optional only when the workspace has exactly one account for the provider. With several and no `accountId`, the call returns `422` with the account ids in `valid_values` instead of guessing. An `accountId` that is not connected to this workspace returns `404`. Disconnecting one account leaves the others connected.\n\n**What happens.** The account's stored authorization is removed and it stops syncing. Its listings are **deactivated**, not deleted: they stop counting toward your plan's listing limit, their data is kept, and they are returned in `listingsDeactivated`. A listing that is still connected through another account or channel stays active. Reconnect the account, then activate the listings with `POST /v1/listings/status`.\n\nThe change is all or nothing. For Airbnb, the host can also revoke access on Airbnb's side (Account \u2192 Privacy & sharing \u2192 Connected apps); that alone does not update this workspace, so call this endpoint as well.\n\n**PMS.** A workspace has one connection per PMS, so no `accountId` is needed. Disconnecting stops syncing, clears the stored credentials and deactivates the connection's listings; nothing is deleted, and reservations and messages stay. The response also carries `connectionId`. The PMS's own webhook subscription is left in place, because the same PMS account can be connected to another workspace (such as a Repull Migrate workspace). Reconnect with a new Connect session.\n\nOther providers return `501 not_implemented` with instructions for disconnecting on the provider's side. That answer depends only on the provider, not on your workspace: an unsupported provider returns `501` whether or not you have a connection to it. `404 not_found` on a supported provider means this workspace has no connection to it (or, with `accountId`, that the account is not connected here).",
         "tags": [
           "Connect"
         ],
@@ -25143,7 +26062,7 @@
       "get": {
         "operationId": "listListings",
         "summary": "List listings",
-        "description": "Cursor-paginated list of listings owned by the authenticated workspace. Use `pagination.nextCursor` from one response as the `cursor` query param of the next request to walk the full set. `?offset=` is also accepted as a first-class alias for shallow paging (0..10000) \u2014 see the `offset` parameter below. Mutually exclusive with `cursor`. Filters: `q` (substring on name/street/city), `status`, `channel`.\n\n**Optional expansions:** Pass `?include=content` to enrich each row with the rich content slab (summary, description, space, house rules, etc. \u2014 sourced from `listings_descriptions` for the `en` locale). Pass `?include=details` for the structural slab (bedrooms, bathrooms, person capacity, check-in window, wifi, house manual, etc.). Both default to `null` per row when the underlying `listings_descriptions` / `listings_details` row is missing \u2014 distinct from the field being absent (which signals the expansion was not requested). Pass `?include=thumbnail` to guarantee `thumbnailUrl` on every returned row \u2014 including the reduced inactive ones. Combine comma-separated, e.g. `?include=content,thumbnail`. The default response stays lean; consumers must opt in.\n\n**Inactive listings:** by default only active listings are returned. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated, so when `status` asks for inactive ones they carry only `id`, `name`, `status` and `channels` \u2014 enough to choose what to activate with `PATCH /v1/listings/{id}`. The `content` and `details` expansions are not applied to them. `?include=thumbnail` is the one exception: it adds `thumbnailUrl` to an inactive row so a single request can render an active/inactive selection screen with pictures, instead of one follow-up call per listing (which an inactive listing would answer with `403 listing_inactive` anyway).",
+        "description": "Cursor-paginated list of listings owned by the authenticated workspace. Use `pagination.nextCursor` from one response as the `cursor` query param of the next request to walk the full set. `?offset=` is also accepted as a first-class alias for shallow paging (0..10000) \u2014 see the `offset` parameter below. Mutually exclusive with `cursor`. Filters: `q` (substring on name/street/city), `status`, `channel`.\n\n**Optional expansions:** Pass `?include=content` to enrich each row with the rich content slab (summary, description, space, house rules, etc. \u2014 sourced from `listings_descriptions` for the `en` locale). Pass `?include=details` for the structural slab (bedrooms, bathrooms, person capacity, check-in window, wifi, house manual, etc.). Both default to `null` per row when the underlying `listings_descriptions` / `listings_details` row is missing \u2014 distinct from the field being absent (which signals the expansion was not requested). Pass `?include=thumbnail` to guarantee `thumbnailUrl` on every returned row \u2014 including the reduced inactive ones. Pass `rooms`, `policies`, `rules`, `pricing`, `fees`, `taxes` or `photos` for the same sections as `GET /v1/listings/{id}`, loaded for the whole page in one go. Combine comma-separated, e.g. `?include=content,thumbnail`. The default response stays lean; consumers must opt in.\n\n**Inactive listings:** by default only active listings are returned. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated, so when `status` asks for inactive ones they carry only `id`, `name`, `status` and `channels` \u2014 enough to choose what to activate with `PATCH /v1/listings/{id}`. The `content` and `details` expansions are not applied to them. `?include=thumbnail` is the one exception: it adds `thumbnailUrl` to an inactive row so a single request can render an active/inactive selection screen with pictures, instead of one follow-up call per listing (which an inactive listing would answer with `403 listing_inactive` anyway).",
         "tags": [
           "Listings"
         ],
@@ -25213,7 +26132,7 @@
               "type": "string",
               "example": "content,thumbnail"
             },
-            "description": "Comma-separated optional expansions. Currently supported: `content`, `details`, `thumbnail`. `thumbnail` guarantees `thumbnailUrl` on every row and is the only expansion that applies to inactive listings. Unknown values return 422 with a `valid_values` envelope. (Note: `amenities` is not yet supported on the list endpoint \u2014 use the detail endpoint to fetch amenity rows for a single listing.)"
+            "description": "Comma-separated optional expansions. Currently supported: `content`, `details`, `thumbnail`, `rooms`, `policies`, `rules`, `pricing`, `fees`, `taxes`, `photos` (the last seven are described on `GET /v1/listings/{id}`; read for the whole page at once). `thumbnail` guarantees `thumbnailUrl` on every row and is the only expansion that applies to inactive listings. Unknown values return 422 with a `valid_values` envelope. (Note: `amenities` is not yet supported on the list endpoint \u2014 use the detail endpoint to fetch amenity rows for a single listing.)"
           }
         ],
         "responses": {
@@ -25276,7 +26195,7 @@
       "get": {
         "operationId": "getListing",
         "summary": "Get a listing",
-        "description": "Fetch a single listing by id. Returns the same shape as one element of the `GET /v1/listings` response, so you can bind the result to the same model. Cross-tenant access (a listing that belongs to a different workspace) returns 404 \u2014 never 403, never reveals the listing's existence.\n\n**Optional expansions:** Pass `?include=amenities` to enrich the response with the listing's amenity rows (`[]` when the listing has none). Pass `?include=content` for the rich content slab (summary, description, space, house rules, etc. \u2014 sourced from `listings_descriptions` for the `en` locale; `null` when no row is stored). Pass `?include=details` for the structural slab (bedrooms, bathrooms, person capacity, check-in window, wifi, house manual, etc.; `null` when no row is stored). Combine comma-separated, e.g. `?include=amenities,content,details`. The default response stays lean; consumers must opt in.\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.",
+        "description": "Fetch a single listing by id. Returns the same shape as one element of the `GET /v1/listings` response, so you can bind the result to the same model. Cross-tenant access (a listing that belongs to a different workspace) returns 404 \u2014 never 403, never reveals the listing's existence.\n\n**Optional expansions:** Pass `?include=amenities` to enrich the response with the listing's amenity rows (`[]` when the listing has none). Pass `?include=content` for the rich content slab (summary, description, space, house rules, etc. \u2014 sourced from `listings_descriptions` for the `en` locale; `null` when no row is stored). Pass `?include=details` for the structural slab (bedrooms, bathrooms, person capacity, check-in window, wifi, house manual, etc.; `null` when no row is stored). Pass `?include=rooms` for rooms and beds, `policies` for cancellation, house rules, check-in/out and guest rules, `rules` for stay rules (min/max nights, booking window, notice, preparation time), `pricing` for standing prices and discounts, `fees` and `taxes` for every fee and tax in one shape whatever channel or PMS the listing comes from, and `photos`. Combine comma-separated, e.g. `?include=content,details,rooms,policies,pricing,fees,taxes`. The default response stays lean; consumers must opt in.\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": [
           "Listings"
         ],
@@ -25301,7 +26220,7 @@
               "type": "string",
               "example": "content,details"
             },
-            "description": "Comma-separated optional expansions. Currently supported: `amenities`, `content`, `details`. Unknown values return 422 with a `valid_values` envelope."
+            "description": "Comma-separated optional expansions. Currently supported: `amenities`, `content`, `details`, `rooms`, `policies`, `rules`, `pricing`, `fees`, `taxes`, `photos`. Unknown values return 422 with a `valid_values` envelope."
           }
         ],
         "responses": {
@@ -32908,6 +33827,7 @@
                           "status",
                           "checkIn",
                           "checkOut",
+                          "guest",
                           "guests",
                           "expectedPayout",
                           "reservationId",
@@ -32963,6 +33883,23 @@
                             "nullable": true,
                             "example": "2026-10-11"
                           },
+                          "guest": {
+                            "type": "object",
+                            "description": "Who asked. Airbnb shares only the guest\u2019s first name before they book; the last name and phone number arrive on the reservation (`GET /v1/reservations/{id}`) once they do.",
+                            "properties": {
+                              "id": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "Repull guest id.",
+                                "example": "365763"
+                              },
+                              "firstName": {
+                                "type": "string",
+                                "nullable": true,
+                                "example": "Ximena"
+                              }
+                            }
+                          },
                           "guests": {
                             "type": "object",
                             "properties": {
@@ -37275,7 +38212,7 @@
       "post": {
         "operationId": "quote_reservation",
         "summary": "Quote a reservation in the PMS",
-        "description": "Prices a stay and checks its availability **in the PMS that manages the listing**, without booking anything. It is the same check `POST /v1/reservations` makes before booking when no `totalPrice` is sent, so `available: true` with a `total` is what that create would be priced at (dates can still be taken in between).\n\n`available: false` is an answer, not an error: the PMS's reasons are in `restrictions` (minimum stay, closed to arrival, taken dates\u2026).\n\n- A listing **not managed in a PMS** answers `422 pms_not_linked`. Book it directly with `POST /v1/reservations`, or price it with `GET /v1/quotes`.\n- A PMS **without a quote API** (Mews, Cloudbeds, iGMS) answers `422 pms_write_unsupported`. You can still create the booking; on iGMS a `totalPrice` is required.\n\n`GET /v1/listings/{id}` \u2192 `capabilities.reservations.quote` says whether a listing can be quoted.\n\n### Per-PMS limits\n\n| PMS | create | change | cancel | quote | `totalPrice` | Limits |\n|---|---|---|---|---|---|---|\n| Mews | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 | \u2014 |\n| Cloudbeds | \u2713 | \u2713 | \u2713 | \u2013 | \u2013 | Books at the rate plan's price; group bookings supported. |\n| Hostaway | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Direct-channel bookings only; a specific unit is refused; a date change keeps the booked total. |\n| Guesty | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Cancels direct and Vrbo bookings; other channel bookings are cancelled on the channel. |\n| Beds24 | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs the `write:bookings` scope; a multi-room property needs `unitId`. |\n| BookingSync | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs `bookings_write`; fees and taxes are not itemized; no guest email. |\n| Lodgify | \u2713 | \u2713 | \u2713 (declines) | \u2713 | \u2713 | Cancel declines the booking; single-room bookings. |\n| Smoobu | \u2713 | \u2713 (no dates) | \u2713 | \u2713 | \u2713 | Dates cannot be changed through Smoobu's API \u2014 cancel and rebook, or change them in Smoobu. |\n| Hospitable | \u2713 | \u2713 | \u2713 | \u2713 (Direct plan) | \u2713 | Manual reservations only; needs `reservation:write`; adds no fees or taxes. |\n| iGMS | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 (required) | iGMS direct bookings only; a price is required; no tentative holds. |\n| OwnerRez | \u2713 | \u2713 | \u2013 | \u2713 | \u2013 | No cancel through OwnerRez's API; priced by the property's own rates; needs the `full` scope. |\n| Track | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Track decides Hold vs Confirmed from the property's channel mode; a set price on a Channel Key needs \"Allow Custom Pricing\"; a unit change needs `moveReasonId` on the connection; a date change re-prices at Track's current rates. |\n\nEvery PMS except Cloudbeds refuses group bookings, and every vacation-rental PMS refuses to change or cancel a booking that came from a channel (Airbnb, Booking.com, Vrbo\u2026) \u2014 that is done on the channel.\n\n**Verification.** Mews and Cloudbeds were run end to end on their vendors' sandboxes. Every other PMS is **verified against the vendor's API documentation only** \u2014 no live account has been written to yet. `capabilities.reservations.verifiedAgainst` says which.\n\n`X-Account-Id` restricts the listing to one connected account. Returns `403 listing_inactive` when the listing is inactive.",
+        "description": "Prices a stay and checks its availability **in the PMS that manages the listing**, without booking anything. It is the same check `POST /v1/reservations` makes before booking when no `totalPrice` is sent, so `available: true` with a `total` is what that create would be priced at (dates can still be taken in between).\n\n`available: false` is an answer, not an error: the PMS's reasons are in `restrictions` (minimum stay, closed to arrival, taken dates\u2026).\n\n- A listing **not managed in a PMS** answers `422 pms_not_linked`. Book it directly with `POST /v1/reservations`, or price it with `GET /v1/quotes`.\n- A PMS **without a quote API** (Mews, Cloudbeds, iGMS) answers `422 pms_write_unsupported`. You can still create the booking; on iGMS a `totalPrice` is required.\n\n`GET /v1/listings/{id}` \u2192 `capabilities.reservations.quote` says whether a listing can be quoted.\n\n### Per-PMS limits\n\n| PMS | create | change | cancel | quote | `totalPrice` | Limits |\n|---|---|---|---|---|---|---|\n| Mews | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 | \u2014 |\n| Cloudbeds | \u2713 | \u2713 | \u2713 | \u2013 | \u2013 | Books at the rate plan's price; group bookings supported. |\n| Hostaway | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Direct-channel bookings only; a specific unit is refused; a date change keeps the booked total. |\n| Guesty | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Cancels direct and Vrbo bookings; other channel bookings are cancelled on the channel. |\n| Beds24 | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs the `write:bookings` scope; a multi-room property needs `unitId`. |\n| BookingSync | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Needs `bookings_write`; fees and taxes are not itemized; no guest email. |\n| Lodgify | \u2713 | \u2713 | \u2713 (declines) | \u2713 | \u2713 | Cancel declines the booking; single-room bookings. |\n| Smoobu | \u2713 | \u2713 (no dates) | \u2713 | \u2713 | \u2713 | Dates cannot be changed through Smoobu's API \u2014 cancel and rebook, or change them in Smoobu. |\n| Hospitable | \u2713 | \u2713 | \u2713 | \u2713 (Direct plan) | \u2713 | Manual reservations only; needs `reservation:write`; adds no fees or taxes. |\n| iGMS | \u2713 | \u2713 | \u2713 | \u2013 | \u2713 (required) | iGMS direct bookings only; a price is required; no tentative holds. |\n| OwnerRez | \u2713 | \u2713 | \u2013 | \u2713 | \u2013 | No cancel through OwnerRez's API; priced by the property's own rates; needs the `full` scope. |\n| Track | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | Track decides Hold vs Confirmed from the property's channel mode; a set price on a Channel Key needs \"Allow Custom Pricing\"; a unit change needs `moveReasonId` on the connection; a date change re-prices at Track's current rates. |\n| CiiRUS | \u2713 | \u2713 | \u2713 | \u2713 | \u2713 | A set price is the rent, with CiiRUS adding its taxes; no tentative holds. |\n\nEvery PMS except Cloudbeds refuses group bookings, and every vacation-rental PMS refuses to change or cancel a booking that came from a channel (Airbnb, Booking.com, Vrbo\u2026) \u2014 that is done on the channel.\n\n**Verification.** Mews and Cloudbeds were run end to end on their vendors' sandboxes. Every other PMS is **verified against the vendor's API documentation only** \u2014 no live account has been written to yet. `capabilities.reservations.verifiedAgainst` says which.\n\n`X-Account-Id` restricts the listing to one connected account. Returns `403 listing_inactive` when the listing is inactive.",
         "tags": [
           "Reservations"
         ],
@@ -39275,6 +40212,974 @@
           }
         }
       }
+    },
+    "/v1/migrations/channex": {
+      "post": {
+        "operationId": "importFromChannex",
+        "summary": "Import from Channex",
+        "description": "Move a workspace off Channex without changing a single id on your side. Pass your Channex API key: Repull reads your Channex properties, room types, rate plans, webhooks, signing keys, channels and upcoming bookings through Channex's own API (read-only \u2014 nothing is written to Channex, and the key is not stored). Each Channex property is matched to your Repull listing or hotel (by Booking.com hotel/room and Airbnb/Vrbo listing ids, then by title and address) or created; every Channex id then resolves, and is returned, unchanged on the Channex-compatible API at `/channex/api/v1`. Webhooks are recreated inactive; activate them with `POST /channex/api/v1/migration/cutover`. Safe to re-run: a run that hits its time budget returns `complete: false` and the next run continues.",
+        "tags": [
+          "Migrate"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "apiKey"
+                ],
+                "properties": {
+                  "apiKey": {
+                    "type": "string",
+                    "description": "Your Channex API key (the `user-api-key` header value). Used for this request only."
+                  },
+                  "environment": {
+                    "type": "string",
+                    "enum": [
+                      "production",
+                      "staging"
+                    ],
+                    "default": "production",
+                    "description": "`production` reads app.channex.io, `staging` reads staging.channex.io."
+                  },
+                  "dryRun": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Match and report without writing anything."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Dry run: what the import would do",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "format": "uuid"
+                        },
+                        "environment": {
+                          "type": "string",
+                          "enum": [
+                            "production",
+                            "staging"
+                          ]
+                        },
+                        "dryRun": {
+                          "type": "boolean"
+                        },
+                        "complete": {
+                          "type": "boolean",
+                          "description": "False when the time budget ran out; run the same request again to continue."
+                        },
+                        "startedAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
+                        "finishedAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
+                        "summary": {
+                          "type": "object",
+                          "properties": {
+                            "properties": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "roomTypes": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "ratePlans": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "webhooks": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "signingKeys": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "channels": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "bookings": {
+                              "type": "object",
+                              "properties": {
+                                "read": {
+                                  "type": "integer"
+                                },
+                                "linked": {
+                                  "type": "integer"
+                                },
+                                "waiting": {
+                                  "type": "integer"
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "properties": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "roomTypes": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "ratePlans": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "webhooks": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "signingKeys": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "channels": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              },
+                              "channel": {
+                                "type": "string",
+                                "description": "Channex adapter code (BookingCom, AirBNB, VRBO\u2026)."
+                              },
+                              "providerSwitch": {
+                                "type": "string",
+                                "enum": [
+                                  "switched",
+                                  "required",
+                                  "unsupported"
+                                ]
+                              },
+                              "instructions": {
+                                "type": "string",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "warnings": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "nextSteps": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "The import report",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "format": "uuid"
+                        },
+                        "environment": {
+                          "type": "string",
+                          "enum": [
+                            "production",
+                            "staging"
+                          ]
+                        },
+                        "dryRun": {
+                          "type": "boolean"
+                        },
+                        "complete": {
+                          "type": "boolean",
+                          "description": "False when the time budget ran out; run the same request again to continue."
+                        },
+                        "startedAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
+                        "finishedAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
+                        "summary": {
+                          "type": "object",
+                          "properties": {
+                            "properties": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "roomTypes": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "ratePlans": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "webhooks": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "signingKeys": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "channels": {
+                              "type": "object",
+                              "properties": {
+                                "matched": {
+                                  "type": "integer"
+                                },
+                                "created": {
+                                  "type": "integer"
+                                },
+                                "needsAction": {
+                                  "type": "integer"
+                                }
+                              }
+                            },
+                            "bookings": {
+                              "type": "object",
+                              "properties": {
+                                "read": {
+                                  "type": "integer"
+                                },
+                                "linked": {
+                                  "type": "integer"
+                                },
+                                "waiting": {
+                                  "type": "integer"
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "properties": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "roomTypes": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "ratePlans": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "webhooks": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "signingKeys": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "channels": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "channexId": {
+                                "type": "string",
+                                "format": "uuid",
+                                "description": "The Channex id, which keeps resolving on `/channex/api/v1`."
+                              },
+                              "title": {
+                                "type": "string",
+                                "nullable": true
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "matched",
+                                  "created",
+                                  "needs_action"
+                                ]
+                              },
+                              "detail": {
+                                "type": "string",
+                                "nullable": true,
+                                "description": "How it was matched, or what to do."
+                              },
+                              "repullListingId": {
+                                "type": "integer",
+                                "nullable": true
+                              },
+                              "channel": {
+                                "type": "string",
+                                "description": "Channex adapter code (BookingCom, AirBNB, VRBO\u2026)."
+                              },
+                              "providerSwitch": {
+                                "type": "string",
+                                "enum": [
+                                  "switched",
+                                  "required",
+                                  "unsupported"
+                                ]
+                              },
+                              "instructions": {
+                                "type": "string",
+                                "nullable": true
+                              }
+                            }
+                          }
+                        },
+                        "warnings": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "nextSteps": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "502": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/connect/ciirus/credentials": {
+      "post": {
+        "operationId": "submitCiirusCredentials",
+        "summary": "Submit CiiRUS credentials for a Connect session",
+        "description": "Completes a credentials-pattern connection for CiiRUS with the property manager's CiiRUS API username and password.\n\n**What syncs.** Units become listings (with descriptions, photos, amenities, rooms and house rules); reservations (with their charge and tax breakdown and payments) and reviews are imported, then polled for changes. Bookings can be created, quoted, changed and cancelled in CiiRUS \u2014 see `capabilities.reservations` on `GET /v1/connect/ciirus`. Guest messages are not available through CiiRUS's API.\n\n**Where the credentials come from.** The CiiRUS API Explorer gives the API username and password after signing in with the CiiRUS MC username and company password; CiiRUS support can also issue them. Credentials that see several suppliers (management companies) also need `managementCompanyUserId`.\n\n**IP whitelist.** CiiRUS only accepts calls from whitelisted IP addresses, and answers a wrong password and a non-whitelisted address the same way. When this returns `invalid_credentials` with correct credentials, ask CiiRUS support to whitelist Repull for the API user.\n\nThe credentials are validated against CiiRUS before anything is stored, so invalid ones return `invalid_credentials` rather than creating a dead connection. On success only the credential fields below are stored, and the first sync of listings and reservations is queued.\n\nCiiRUS has no webhooks: after the first sync, reservation changes are picked up by polling about once a minute.\n\nReconnecting replaces the stored credentials on the workspace's existing CiiRUS connection \u2014 the `pmsConnectionId` stays the same.\n\nNo API key required when called with a `sessionId` \u2014 the session is the capability token.",
+        "tags": [
+          "Connect"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "sessionId": {
+                    "type": "string",
+                    "description": "Connect session id from `POST /v1/connect/ciirus`. Omit when calling with your API key."
+                  },
+                  "writePolicy": {
+                    "type": "object",
+                    "description": "Optional: what the app may change in CiiRUS, set before the first sync. Same shape as `PATCH /v1/connect/{provider}/write-policy`; switches you leave out keep the provider default (everything on).",
+                    "example": {
+                      "reservations": {
+                        "api": false
+                      }
+                    }
+                  },
+                  "credentials": {
+                    "type": "object",
+                    "description": "The CiiRUS API username and password.",
+                    "properties": {
+                      "apiUsername": {
+                        "type": "string",
+                        "description": "CiiRUS API username, from the CiiRUS API Explorer or CiiRUS support."
+                      },
+                      "apiPassword": {
+                        "type": "string",
+                        "description": "CiiRUS API password."
+                      },
+                      "managementCompanyUserId": {
+                        "type": "integer",
+                        "description": "The CiiRUS supplier (management company) id, the MCUserID. Only needed when the credentials see several suppliers.",
+                        "example": 42330
+                      }
+                    },
+                    "required": [
+                      "apiUsername",
+                      "apiPassword"
+                    ]
+                  }
+                },
+                "required": [
+                  "credentials"
+                ]
+              },
+              "example": {
+                "credentials": {
+                  "apiUsername": "AcmeVacationsAPI",
+                  "apiPassword": "\u2026"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Credentials accepted, the connection stored and its first sync queued",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "provider": {
+                      "type": "string",
+                      "example": "ciirus"
+                    },
+                    "connected": {
+                      "type": "boolean"
+                    },
+                    "pmsConnectionId": {
+                      "type": "string",
+                      "description": "Id of the stored connection."
+                    },
+                    "created": {
+                      "type": "boolean",
+                      "description": "False when an existing connection was updated."
+                    },
+                    "sessionId": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "accountInfo": {
+                      "type": "object",
+                      "properties": {
+                        "supplierId": {
+                          "type": "string",
+                          "description": "The CiiRUS supplier (management company) id the connection reads.",
+                          "example": "42330"
+                        },
+                        "accountName": {
+                          "type": "string",
+                          "nullable": true,
+                          "description": "The supplier's company name."
+                        }
+                      }
+                    },
+                    "firstSync": {
+                      "type": "object",
+                      "description": "Whether the first import of listings and reservations was queued. When it was not, the connection still stands and polling syncs it.",
+                      "properties": {
+                        "queued": {
+                          "type": "boolean"
+                        },
+                        "error": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "writePolicy": {
+                      "$ref": "#/components/schemas/PmsWritePolicy"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "CiiRUS could not be reached (`network_error`). Nothing was stored.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
     }
   }
 }