{"openapi":"3.1.0","info":{"title":"Nowistay Public API","description":"REST access to properties, calendars, bookings and payment requests, guests, missions, conversations, private knowledge, welcome guides, upsells and reporting. There are 25 opt-in scopes. Each operation documents its required permissions and examples. Existing tokens retain their grants: create replacement personal credentials or register the desired partner scope set and obtain fresh consent. Secret rotation and refresh do not add scopes. See /public/docs for the scope-upgrade guide and runnable examples.","version":"1.0.0"},"paths":{"/public/v1/properties":{"get":{"tags":["public-api"],"summary":"List Public Properties","operationId":"list_public_properties_public_v1_properties_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Search"},"examples":{"property-search":{"summary":"Find a property","value":"Apartment"}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["properties.read"]}],"description":"\n\n### Find a property\nRequired scopes (all): `properties.read`.\n\nSearch the eligible properties owned by your account.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/properties?search=Apartment' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/properties/{property_id}/calendar":{"get":{"tags":["public-api"],"summary":"Get property calendar","description":"Returns availability, nightly rate, stay rules, sales closures, effective restrictions, and the host's private note for every date in the requested inclusive range, up to 730 days. Availability is remaining inventory after bookings, and 0 on nights a linked property (the whole property it belongs to, or one of its rooms) is booked. The property must belong to the authenticated account, have an active AI Channel Manager subscription, and have calendar management enabled.","operationId":"get_public_property_calendar_public_v1_properties__property_id__calendar_get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Inclusive start date (YYYY-MM-DD).","title":"From"},"description":"Inclusive start date (YYYY-MM-DD)."},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Inclusive end date (YYYY-MM-DD).","title":"To"},"description":"Inclusive end date (YYYY-MM-DD)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCalendarResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["calendar.read"]}]},"patch":{"tags":["public-api"],"summary":"Update property calendar","description":"Partially updates availability, nightly rate, stay rules, or the host's private note over an inclusive date range. Omitted calendar fields keep their current values. Omit daysOfWeek to update every date. Successful changes are propagated to connected booking channels; the note never is. The property must belong to the authenticated account, have an active AI Channel Manager subscription, and have calendar management enabled. Nights a linked property is booked stay closed on the channels whatever availability is set. Manual prices lock nights against AI Pricing automatic updates.","operationId":"update_public_property_calendar_public_v1_properties__property_id__calendar_patch","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCalendarPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCalendarUpdateResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["calendar.write"]}]}},"/public/v1/bookings":{"get":{"tags":["public-api"],"summary":"List Public Bookings","operationId":"list_public_bookings_public_v1_bookings_get","parameters":[{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"}},{"name":"propertyIds","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Propertyids"},"examples":{"booking-table":{"summary":"Export a booking table","value":[101,102]}}},{"name":"responseFormat","in":"query","required":false,"schema":{"enum":["json","table"],"type":"string","default":"json","title":"Responseformat"},"examples":{"booking-table":{"summary":"Export a booking table","value":"table"}}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/BookingStatus"},{"type":"null"}],"title":"Status"}},{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/BookingChannel"},{"type":"null"}],"title":"Channel"}},{"name":"fromDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fromdate"},"examples":{"booking-table":{"summary":"Export a booking table","value":"2026-12-01"}}},{"name":"toDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Todate"},"examples":{"booking-table":{"summary":"Export a booking table","value":"2026-12-31"}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"},"examples":{"booking-table":{"summary":"Export a booking table","value":500}}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"},"examples":{"booking-table":{"summary":"Export a booking table","value":0}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingListResponse"},{"$ref":"#/components/schemas/PublicTableResult"}],"title":"Response List Public Bookings Public V1 Bookings Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["bookings.read"]}],"description":"\n\n### Export a booking table\nRequired scopes (all): `bookings.read`.\n\nReturns columns, rows and pagination. Table limit is 500; default JSON remains capped at 100. Dates retain overlap semantics: departure >= fromDate and arrival <= toDate. Cleaning assignments also need missions.read; conversation presence needs messages.read.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/bookings?propertyIds=101&propertyIds=102&responseFormat=table&limit=500&offset=0&fromDate=2026-12-01&toDate=2026-12-31' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"post":{"tags":["public-api"],"summary":"Create Public Booking","operationId":"create_public_booking_public_v1_bookings_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingCreate"},"examples":{"booking-create":{"summary":"Create a direct booking","description":"Required scopes (all): bookings.write. Requires an active PMS connection. Creation defaults to silent=false. Add bookings.read for booking details.","value":{"propertyId":101,"arrival":"2026-12-18","departure":"2026-12-20","guestFirstName":"Maya","guestLastName":"Martin","guestEmail":"maya@example.com","adults":2,"amount":"290.00","currency":"EUR","requestPayment":false}},"booking-payment":{"summary":"Create a booking and request payment","description":"Required scopes (all): bookings.write, payments.write. Both scopes are required. The booking starts pending payment. If payment-link generation fails, creation still succeeds: inspect paymentRequest.sent and error before retrying to avoid duplicate bookings.","value":{"propertyId":101,"arrival":"2026-12-18","departure":"2026-12-20","guestFirstName":"Maya","guestLastName":"Martin","guestEmail":"maya@example.com","adults":2,"amount":"290.00","currency":"EUR","requestPayment":true}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingCreateResponse"},"examples":{"payment-link-failed":{"summary":"Booking created; payment request failed (write-only token)","value":{"booking":{"id":9001},"paymentRequest":{"requested":true,"sent":false,"checkoutUrl":null,"error":"Payment request could not be created. The booking was created."}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["bookings.write"]}],"description":"Create a direct booking. Requires an active PMS connection. requestPayment=true also requires payments.write. Payment-link failure leaves the booking created and returns an explicit payment failure. The full booking is returned only with bookings.read; otherwise the result contains its ID.\n\n### Create a direct booking\nRequired scopes (all): `bookings.write`.\n\nRequires an active PMS connection. Creation defaults to silent=false. Add bookings.read for booking details.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/bookings \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"propertyId\": 101,\n  \"arrival\": \"2026-12-18\",\n  \"departure\": \"2026-12-20\",\n  \"guestFirstName\": \"Maya\",\n  \"guestLastName\": \"Martin\",\n  \"guestEmail\": \"maya@example.com\",\n  \"adults\": 2,\n  \"amount\": \"290.00\",\n  \"currency\": \"EUR\",\n  \"requestPayment\": false\n}'\n```\n\n### Create a booking and request payment\nRequired scopes (all): `bookings.write`, `payments.write`.\n\nBoth scopes are required. The booking starts pending payment. If payment-link generation fails, creation still succeeds: inspect paymentRequest.sent and error before retrying to avoid duplicate bookings.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/bookings \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"propertyId\": 101,\n  \"arrival\": \"2026-12-18\",\n  \"departure\": \"2026-12-20\",\n  \"guestFirstName\": \"Maya\",\n  \"guestLastName\": \"Martin\",\n  \"guestEmail\": \"maya@example.com\",\n  \"adults\": 2,\n  \"amount\": \"290.00\",\n  \"currency\": \"EUR\",\n  \"requestPayment\": true\n}'\n```","x-conditional-scopes":{"requestPayment=true":["bookings.write","payments.write"]}}},"/public/v1/bookings/{booking_id}":{"get":{"tags":["public-api"],"summary":"Get Public Booking","operationId":"get_public_booking_public_v1_bookings__booking_id__get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"integer","title":"Booking Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingDetail"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["bookings.read"]}]},"patch":{"tags":["public-api"],"summary":"Patch Public Booking","operationId":"patch_public_booking_public_v1_bookings__booking_id__patch","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"integer","title":"Booking Id"},"examples":{"booking-reference":{"summary":"Update a reservation reference and notes","value":9001},"booking-cancel":{"summary":"Cancel without a refund","value":9001},"booking-full-refund":{"summary":"Cancel and request a full refund","value":9001},"booking-partial-refund":{"summary":"Cancel and request a partial refund","value":9001},"booking-parameters-only":{"summary":"Update only custom parameters","value":9001},"booking-mixed-update":{"summary":"Update notes and custom parameters atomically","value":9001}}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingPatch"},"examples":{"booking-reference":{"summary":"Update a reservation reference and notes","description":"Required scopes (all): bookings.write. Existing PATCH defaults to silent=true. Contact, postal address, notes and check-in/out edits remain supported when a payment order exists.","value":{"reservationNumber":"DIRECT-9001","notes":"Guest requested a baby cot.","silent":true}},"booking-cancel":{"summary":"Cancel without a refund","description":"Required scopes (all): bookings.write. No payments.write scope is required when no refund is requested.","value":{"status":"cancelled","cancellationRefundMode":"none"}},"booking-full-refund":{"summary":"Cancel and request a full refund","description":"Required scopes (all): bookings.write, payments.write. Both scopes are required. Check payment status before reporting refund completion.","value":{"status":"cancelled","cancellationRefundMode":"full"}},"booking-partial-refund":{"summary":"Cancel and request a partial refund","description":"Required scopes (all): bookings.write, payments.write. The amount must satisfy the booking's refund rules. payments.write does not authorize repricing an existing checkout.","value":{"status":"cancelled","cancellationRefundMode":"partial","cancellationRefundAmount":"50.00"}},"booking-parameters-only":{"summary":"Update only custom parameters","description":"Required scopes (all): booking_parameters.write. Also supported for OTA bookings. Create the parameter definition first; null clears its value. Parameters named <key>_submitted may also be set by the forms integration when a guest submits a form.","value":{"customParameters":{"external_status":null}}},"booking-mixed-update":{"summary":"Update notes and custom parameters atomically","description":"Required scopes (all): bookings.write, booking_parameters.write. Create the parameter definition first. Invalid parameters or denied permissions leave both parts unchanged.","value":{"notes":"Arrival confirmed.","customParameters":{"external_status":"ready"}}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingDetail"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["bookings.write"]},{"OAuth2":["booking_parameters.write"]}],"description":"Update a booking with bookings.write, or only its customParameters with booking_parameters.write. A mixed update requires both scopes. Explicit full or partial cancellation refunds additionally require payments.write. Once a payment order exists, changed dates or pricing are rejected. Paid confirmed bookings cannot return to pending; refunded cancelled bookings cannot be reactivated. Contact, address, notes and check-in/out edits remain supported. Cancellation does not itself confirm refund completion.\n\n### Update a reservation reference and notes\nRequired scopes (all): `bookings.write`.\n\nExisting PATCH defaults to silent=true. Contact, postal address, notes and check-in/out edits remain supported when a payment order exists.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"reservationNumber\": \"DIRECT-9001\",\n  \"notes\": \"Guest requested a baby cot.\",\n  \"silent\": true\n}'\n```\n\n### Cancel without a refund\nRequired scopes (all): `bookings.write`.\n\nNo payments.write scope is required when no refund is requested.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"status\": \"cancelled\",\n  \"cancellationRefundMode\": \"none\"\n}'\n```\n\n### Cancel and request a full refund\nRequired scopes (all): `bookings.write`, `payments.write`.\n\nBoth scopes are required. Check payment status before reporting refund completion.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"status\": \"cancelled\",\n  \"cancellationRefundMode\": \"full\"\n}'\n```\n\n### Cancel and request a partial refund\nRequired scopes (all): `bookings.write`, `payments.write`.\n\nThe amount must satisfy the booking's refund rules. payments.write does not authorize repricing an existing checkout.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"status\": \"cancelled\",\n  \"cancellationRefundMode\": \"partial\",\n  \"cancellationRefundAmount\": \"50.00\"\n}'\n```\n\n### Update only custom parameters\nRequired scopes (all): `booking_parameters.write`.\n\nAlso supported for OTA bookings. Create the parameter definition first; null clears its value. Parameters named <key>_submitted may also be set by the forms integration when a guest submits a form.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"customParameters\": {\n    \"external_status\": null\n  }\n}'\n```\n\n### Update notes and custom parameters atomically\nRequired scopes (all): `bookings.write`, `booking_parameters.write`.\n\nCreate the parameter definition first. Invalid parameters or denied permissions leave both parts unchanged.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/bookings/9001 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"notes\": \"Arrival confirmed.\",\n  \"customParameters\": {\n    \"external_status\": \"ready\"\n  }\n}'\n```","x-conditional-scopes":{"customParameters":["booking_parameters.write"],"bookingFields":["bookings.write"],"cancellationRefundMode=full|partial":["bookings.write","payments.write"]}}},"/public/v1/guests":{"get":{"tags":["public-api"],"summary":"List Public Guests","description":"List the owner's guest (customer) base with booking totals.\n\nGuests are owner-level: `customers.read` exposes the deduplicated customer\nbase across ALL of the owner's properties, regardless of per-property\nrestrictions on other scopes. Use `updatedAfter` to poll incrementally.\n\n### Filter and sort guest records\nRequired scopes (all): `customers.read`.\n\nOmit property filters to retain the owner-wide customer base. Prefix orderBy with - for descending order.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/guests?propertyIds=101&propertyIds=102&orderBy=-last_stay' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```","operationId":"list_public_guests_public_v1_guests_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Search"}},{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"}},{"name":"propertyIds","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Propertyids"},"examples":{"guest-sort":{"summary":"Filter and sort guest records","value":[101,102]}}},{"name":"orderBy","in":"query","required":false,"schema":{"type":"string","pattern":"^-?(created_at|updated_at|full_name|bookings_count|total_amount|last_stay)$","default":"-updated_at","title":"Orderby"},"examples":{"guest-sort":{"summary":"Filter and sort guest records","value":"-last_stay"}}},{"name":"updatedAfter","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedafter"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuestProfileListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["customers.read"]}]},"post":{"tags":["public-api"],"summary":"Create Guest","operationId":"create_guest_public_v1_guests_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuestCreate"},"examples":{"guest-create":{"summary":"Create a guest record","description":"Required scopes (all): customers.write. Duplicate guest creation returns 409. Add customers.read to receive the guest profile; otherwise the response contains its ID.","value":{"firstName":"Maya","lastName":"Martin","email":"maya@example.com","language":"en"}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicGuestProfile"},{"$ref":"#/components/schemas/PublicActionResult"}],"title":"Response Create Guest Public V1 Guests Post"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["customers.write"]}],"description":"\n\n### Create a guest record\nRequired scopes (all): `customers.write`.\n\nDuplicate guest creation returns 409. Add customers.read to receive the guest profile; otherwise the response contains its ID.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/guests \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"firstName\": \"Maya\",\n  \"lastName\": \"Martin\",\n  \"email\": \"maya@example.com\",\n  \"language\": \"en\"\n}'\n```"}},"/public/v1/guests/{guest_id}":{"get":{"tags":["public-api"],"summary":"Get Public Guest","description":"Get one guest with booking totals. Owner-level data (see list endpoint).","operationId":"get_public_guest_public_v1_guests__guest_id__get","parameters":[{"name":"guest_id","in":"path","required":true,"schema":{"type":"integer","title":"Guest Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuestProfile"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["customers.read"]}]}},"/public/v1/booking-parameters":{"get":{"tags":["public-api"],"summary":"List Public Booking Parameters","operationId":"list_public_booking_parameters_public_v1_booking_parameters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicBookingParameter"},"type":"array","title":"Response List Public Booking Parameters Public V1 Booking Parameters Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["booking_parameters.read"]}]},"post":{"tags":["public-api"],"summary":"Create Public Booking Parameter","operationId":"create_public_booking_parameter_public_v1_booking_parameters_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingParameterCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingParameter"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["booking_parameters.write"]}]}},"/public/v1/booking-parameters/{key}":{"patch":{"tags":["public-api"],"summary":"Update Public Booking Parameter","operationId":"update_public_booking_parameter_public_v1_booking_parameters__key__patch","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingParameterUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingParameter"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["booking_parameters.write"]}]}},"/public/v1/team-members":{"get":{"tags":["public-api"],"summary":"List Public Team Members","operationId":"list_public_team_members_public_v1_team_members_get","parameters":[{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TeamRole"},{"type":"null"}],"title":"Role"}},{"name":"isActive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTeamMemberListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["team_members.read"]}]}},"/public/v1/missions":{"get":{"tags":["public-api"],"summary":"List Public Missions","operationId":"list_public_missions_public_v1_missions_get","parameters":[{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"}},{"name":"propertyIds","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Propertyids"},"examples":{"mission-filter":{"summary":"Filter team workload","value":[101,102]},"mission-table":{"summary":"Export a mission table","value":[101,102]}}},{"name":"teamMemberIds","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Teammemberids"},"examples":{"mission-filter":{"summary":"Filter team workload","value":[301]}}},{"name":"fromDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fromdate"},"examples":{"mission-filter":{"summary":"Filter team workload","value":"2026-12-01"}}},{"name":"toDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Todate"},"examples":{"mission-filter":{"summary":"Filter team workload","value":"2026-12-31"}}},{"name":"responseFormat","in":"query","required":false,"schema":{"enum":["json","table"],"type":"string","default":"json","title":"Responseformat"},"examples":{"mission-table":{"summary":"Export a mission table","value":"table"}}},{"name":"bookingId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"}},{"name":"missionType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Missiontype"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MissionStatus"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"},"examples":{"mission-table":{"summary":"Export a mission table","value":500}}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"},"examples":{"mission-table":{"summary":"Export a mission table","value":0}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicMissionListResponse"},{"$ref":"#/components/schemas/PublicTableResult"}],"title":"Response List Public Missions Public V1 Missions Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["missions.read"]}],"description":"\n\n### Filter team workload\nRequired scopes (all): `missions.read`.\n\nfromDate and toDate filter scheduled UTC dates inclusively. Repeat propertyIds and teamMemberIds for multiple values.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/missions?propertyIds=101&propertyIds=102&teamMemberIds=301&fromDate=2026-12-01&toDate=2026-12-31' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```\n\n### Export a mission table\nRequired scopes (all): `missions.read`.\n\nReturns columns, rows and pagination. Multiple propertyIds intersect propertyId when both are supplied. Use offset for subsequent pages.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/missions?propertyIds=101&propertyIds=102&responseFormat=table&limit=500&offset=0' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"post":{"tags":["public-api"],"summary":"Create Public Mission","operationId":"create_public_mission_public_v1_missions_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMissionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMission"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["missions.write"]}]}},"/public/v1/missions/{mission_id}":{"patch":{"tags":["public-api"],"summary":"Patch Public Mission","operationId":"patch_public_mission_public_v1_missions__mission_id__patch","parameters":[{"name":"mission_id","in":"path","required":true,"schema":{"type":"integer","title":"Mission Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMissionPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMission"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["missions.write"]}]},"get":{"tags":["public-api"],"summary":"Get Mission","operationId":"get_mission_public_v1_missions__mission_id__get","parameters":[{"name":"mission_id","in":"path","required":true,"schema":{"type":"integer","title":"Mission Id"},"examples":{"mission-detail":{"summary":"Read a mission","value":701}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMission"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["missions.read"]}],"description":"\n\n### Read a mission\nRequired scopes (all): `missions.read`.\n\nIncludes related booking context under missions.read.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/missions/701 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/properties/{property_id}/activity":{"get":{"tags":["public-api"],"summary":"List Public Property Activity","operationId":"list_public_property_activity_public_v1_properties__property_id__activity_get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicActivityEvent"},"title":"Response List Public Property Activity Public V1 Properties  Property Id  Activity Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["activity.read"]}]}},"/public/v1/webhooks":{"get":{"tags":["public-api"],"summary":"List Public Webhooks","operationId":"list_public_webhooks_public_v1_webhooks_get","parameters":[{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhookListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["webhooks.read"]}]},"post":{"tags":["public-api"],"summary":"Create Public Webhook","description":"Subscriptions that include guest.* events also require customers.read.","operationId":"create_public_webhook_public_v1_webhooks_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhookCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhookCreateResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"x-conditional-scopes":{"guest.* events":["customers.read"]},"security":[{"OAuth2":["webhooks.write","bookings.read"]}]}},"/public/v1/webhooks/{webhook_id}":{"get":{"tags":["public-api"],"summary":"Get Public Webhook","operationId":"get_public_webhook_public_v1_webhooks__webhook_id__get","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhook"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["webhooks.read"]}]},"patch":{"tags":["public-api"],"summary":"Patch Public Webhook","description":"Any update that adds or keeps guest.* events also requires customers.read. Update an existing guest subscription with that scope to authorize guest deliveries.","operationId":"patch_public_webhook_public_v1_webhooks__webhook_id__patch","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhookPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWebhook"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"x-conditional-scopes":{"guest.* events after update":["customers.read"]},"security":[{"OAuth2":["webhooks.write"]}]},"delete":{"tags":["public-api"],"summary":"Delete Public Webhook","operationId":"delete_public_webhook_public_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"204":{"description":"Successful Response"},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["webhooks.write"]}]}},"/public/v1/bookings/{booking_id}/payment-request":{"get":{"tags":["public-api"],"summary":"Get Public Booking Payment Request","operationId":"get_public_booking_payment_request_public_v1_bookings__booking_id__payment_request_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"integer","title":"Booking Id"},"examples":{"booking-payment-status":{"summary":"Read safe payment-request status","value":9001}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingPaymentRequest"},"examples":{"pending":{"summary":"Safe payment-request status","value":{"bookingType":"direct","paymentRequest":{"status":"pending","source":"host"}}},"no-request":{"summary":"Manual booking without a payment request","value":{"bookingType":"manual","paymentRequest":null}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["bookings.read"]}],"description":"\n\n### Read safe payment-request status\nRequired scopes (all): `bookings.read`.\n\nReturns bookingType and paymentRequest status, never a checkout URL. Cancellation alone does not prove a refund completed.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/bookings/9001/payment-request \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/properties/{property_id}":{"get":{"tags":["public-api"],"summary":"Get Property","operationId":"get_property_public_v1_properties__property_id__get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"property-detail":{"summary":"Read property operating settings","value":101}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyDetail"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["properties.read"]}],"description":"\n\n### Read property operating settings\nRequired scopes (all): `properties.read`.\n\nIncludes booking cutoffs and default pricing and stay settings.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"patch":{"tags":["public-api"],"summary":"Patch Property","operationId":"patch_property_public_v1_properties__property_id__patch","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"property-update":{"summary":"Update property operating settings","value":101}}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyPatch"},"examples":{"property-update":{"summary":"Update property operating settings","description":"Required scopes (all): properties.write. Add properties.read to receive property details; write-only access returns its ID.","value":{"capacity":4,"cutOffDays":1,"defaultMinStay":2}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicPropertyDetail"},{"$ref":"#/components/schemas/PublicActionResult"}],"title":"Response Patch Property Public V1 Properties  Property Id  Patch"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["properties.write"]}],"description":"\n\n### Update property operating settings\nRequired scopes (all): `properties.write`.\n\nAdd properties.read to receive property details; write-only access returns its ID.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/properties/101 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"capacity\": 4,\n  \"cutOffDays\": 1,\n  \"defaultMinStay\": 2\n}'\n```"}},"/public/v1/guests/{guest_id}/bookings":{"get":{"tags":["public-api"],"summary":"Guest Bookings","operationId":"guest_bookings_public_v1_guests__guest_id__bookings_get","parameters":[{"name":"guest_id","in":"path","required":true,"schema":{"type":"integer","title":"Guest Id"},"examples":{"guest-history":{"summary":"Read a guest's booking history","value":501}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBookingListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["customers.read","bookings.read"]}],"description":"\n\n### Read a guest's booking history\nRequired scopes (all): `customers.read`, `bookings.read`.\n\nBoth scopes are required. History includes bookings on eligible properties.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/guests/501/bookings \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/missions/{mission_id}/report":{"get":{"tags":["public-api"],"summary":"Mission Report","operationId":"mission_report_public_v1_missions__mission_id__report_get","parameters":[{"name":"mission_id","in":"path","required":true,"schema":{"type":"integer","title":"Mission Id"},"examples":{"mission-report":{"summary":"Read a mission completion report","value":701}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMissionReportResponse"},"examples":{"no-report":{"summary":"Valid mission without a report","value":{"missionId":701,"report":null}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["missions.read"]}],"description":"\n\n### Read a mission completion report\nRequired scopes (all): `missions.read`.\n\nA valid mission without a report returns 200 with report: null.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/missions/701/report \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/upsells":{"get":{"tags":["public-api"],"summary":"List Upsells","operationId":"list_upsells_public_v1_upsells_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicUpsellItem"},"type":"array","title":"Response List Upsells Public V1 Upsells Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["upsells.read"]}],"description":"\n\n### Read the upsell catalog\nRequired scopes (all): `upsells.read`.\n\nRead-only catalog access; booking purchases additionally require bookings.read.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/upsells \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/bookings/{booking_id}/upsell-purchases":{"get":{"tags":["public-api"],"summary":"Upsell Purchases","operationId":"upsell_purchases_public_v1_bookings__booking_id__upsell_purchases_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"integer","title":"Booking Id"},"examples":{"upsell-purchases":{"summary":"Read a booking's upsell purchases","value":9001}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicUpsellPurchase"},"title":"Response Upsell Purchases Public V1 Bookings  Booking Id  Upsell Purchases Get"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["upsells.read","bookings.read"]}],"description":"\n\n### Read a booking's upsell purchases\nRequired scopes (all): `upsells.read`, `bookings.read`.\n\nBoth scopes are required. This endpoint does not create or modify purchases.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/bookings/9001/upsell-purchases \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/conversations":{"get":{"tags":["public-api"],"summary":"List Conversations","operationId":"list_conversations_public_v1_conversations_get","parameters":[{"name":"propertyId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"},"examples":{"conversations":{"summary":"Find guest conversations","value":101}}},{"name":"bookingId","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"},"examples":{"conversations":{"summary":"Find guest conversations","value":9001}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicConversationList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["messages.read"]}],"description":"\n\n### Find guest conversations\nRequired scopes (all): `messages.read`.\n\nFilter by propertyId and/or bookingId; multi-room booking lookups resolve the related conversation.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/conversations?propertyId=101&bookingId=9001' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/conversations/{conversation_id}/messages":{"get":{"tags":["public-api"],"summary":"List Conversation Messages","operationId":"list_conversation_messages_public_v1_conversations__conversation_id__messages_get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"integer","title":"Conversation Id"},"examples":{"message-history":{"summary":"Read conversation messages","value":801}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"},"examples":{"message-history":{"summary":"Read conversation messages","value":20}}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMessageList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["messages.read"]}],"description":"\n\n### Read conversation messages\nRequired scopes (all): `messages.read`.\n\nRead message content, delivery status and related booking context.\n\n```bash\ncurl -X GET 'https://api.nowistay.com/public/v1/conversations/801/messages?limit=20' \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"}},"/public/v1/messages":{"post":{"tags":["public-api"],"summary":"Create Message","operationId":"create_message_public_v1_messages_post","parameters":[{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMessageCreate"},"examples":{"message-booking":{"summary":"Send a host reply for a booking","description":"Required scopes (all): messages.write. Provide exactly one of bookingId or conversationId. A saved message with failed delivery still returns its ID and status. Attachments are not supported.","value":{"bookingId":9001,"message":"Hello Maya, your arrival instructions are ready."}},"message-channel":{"summary":"Send through a selected conversation channel","description":"Required scopes (all): messages.write. channelKind or threadChannelId can select a delivery channel; never provide both. Add messages.read for the detailed message and delivery response.","value":{"conversationId":801,"message":"Your check-in is confirmed.","channelKind":"email"}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicMessageCreated"},{"$ref":"#/components/schemas/PublicMessageAction"}],"title":"Response Create Message Public V1 Messages Post"},"examples":{"delivery-failed":{"summary":"Message saved; delivery failed (write-only token)","value":{"id":901,"conversationId":801,"status":"delivery-failed","deliverySuccess":false}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["messages.write"]}],"description":"\n\n### Send a host reply for a booking\nRequired scopes (all): `messages.write`.\n\nProvide exactly one of bookingId or conversationId. A saved message with failed delivery still returns its ID and status. Attachments are not supported.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/messages \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"bookingId\": 9001,\n  \"message\": \"Hello Maya, your arrival instructions are ready.\"\n}'\n```\n\n### Send through a selected conversation channel\nRequired scopes (all): `messages.write`.\n\nchannelKind or threadChannelId can select a delivery channel; never provide both. Add messages.read for the detailed message and delivery response.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/messages \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"conversationId\": 801,\n  \"message\": \"Your check-in is confirmed.\",\n  \"channelKind\": \"email\"\n}'\n```"}},"/public/v1/properties/{property_id}/knowledge-questions":{"get":{"tags":["public-api"],"summary":"List Knowledge Questions","operationId":"list_knowledge_questions_public_v1_properties__property_id__knowledge_questions_get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"knowledge-list":{"summary":"Read private property knowledge","value":101}}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["knowledge.read"]}],"description":"\n\n### Read private property knowledge\nRequired scopes (all): `knowledge.read`.\n\nRead the property's private questions and answers.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101/knowledge-questions \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"post":{"tags":["public-api"],"summary":"Create Knowledge Question","operationId":"create_knowledge_question_public_v1_properties__property_id__knowledge_questions_post","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"knowledge-create":{"summary":"Add a private knowledge answer","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeCreate"},"examples":{"knowledge-create":{"summary":"Add a private knowledge answer","description":"Required scopes (all): knowledge.write. Add knowledge.read for the complete question response; write-only access returns action identifiers.","value":{"question":"Where is the recycling area?","answer":"In the courtyard, next to the bicycle shelter."}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicKnowledgeQuestion"},{"$ref":"#/components/schemas/PublicContentAction"}],"title":"Response Create Knowledge Question Public V1 Properties  Property Id  Knowledge Questions Post"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["knowledge.write"]}],"description":"\n\n### Add a private knowledge answer\nRequired scopes (all): `knowledge.write`.\n\nAdd knowledge.read for the complete question response; write-only access returns action identifiers.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/properties/101/knowledge-questions \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"question\": \"Where is the recycling area?\",\n  \"answer\": \"In the courtyard, next to the bicycle shelter.\"\n}'\n```"}},"/public/v1/properties/{property_id}/knowledge-questions/copy":{"post":{"tags":["public-api"],"summary":"Copy Knowledge Questions","operationId":"copy_knowledge_questions_public_v1_properties__property_id__knowledge_questions_copy_post","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"knowledge-copy":{"summary":"Merge knowledge into other properties","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeCopy"},"examples":{"knowledge-copy":{"summary":"Merge knowledge into other properties","description":"Required scopes (all): knowledge.read, knowledge.write. Both scopes are required. The URL identifies the source. All targets are validated before writes. Copying never deletes or overwrites target answers.","value":{"targetPropertyIds":[102,103],"questionIds":[201]}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeCopyResult"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["knowledge.read","knowledge.write"]}],"description":"\n\n### Merge knowledge into other properties\nRequired scopes (all): `knowledge.read`, `knowledge.write`.\n\nBoth scopes are required. The URL identifies the source. All targets are validated before writes. Copying never deletes or overwrites target answers.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/properties/101/knowledge-questions/copy \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"targetPropertyIds\": [\n    102,\n    103\n  ],\n  \"questionIds\": [\n    201\n  ]\n}'\n```"}},"/public/v1/properties/{property_id}/knowledge-questions/{question_id}":{"get":{"tags":["public-api"],"summary":"Get Knowledge Question","operationId":"get_knowledge_question_public_v1_properties__property_id__knowledge_questions__question_id__get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"knowledge-detail":{"summary":"Read one knowledge answer","value":101}}},{"name":"question_id","in":"path","required":true,"schema":{"type":"integer","title":"Question Id"},"examples":{"knowledge-detail":{"summary":"Read one knowledge answer","value":201}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeQuestion"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["knowledge.read"]}],"description":"\n\n### Read one knowledge answer\nRequired scopes (all): `knowledge.read`.\n\nRead the current answer before changing it.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101/knowledge-questions/201 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"patch":{"tags":["public-api"],"summary":"Update Knowledge Question","operationId":"update_knowledge_question_public_v1_properties__property_id__knowledge_questions__question_id__patch","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"knowledge-update":{"summary":"Update a private knowledge answer","value":101}}},{"name":"question_id","in":"path","required":true,"schema":{"type":"integer","title":"Question Id"},"examples":{"knowledge-update":{"summary":"Update a private knowledge answer","value":201}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKnowledgeUpdate"},"examples":{"knowledge-update":{"summary":"Update a private knowledge answer","description":"Required scopes (all): knowledge.write. Omitted fields remain unchanged.","value":{"answer":"Use the labelled bins in the courtyard."}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicKnowledgeQuestion"},{"$ref":"#/components/schemas/PublicContentAction"}],"title":"Response Update Knowledge Question Public V1 Properties  Property Id  Knowledge Questions  Question Id  Patch"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["knowledge.write"]}],"description":"\n\n### Update a private knowledge answer\nRequired scopes (all): `knowledge.write`.\n\nOmitted fields remain unchanged.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/properties/101/knowledge-questions/201 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"answer\": \"Use the labelled bins in the courtyard.\"\n}'\n```"}},"/public/v1/properties/{property_id}/welcome-guide":{"get":{"tags":["public-api"],"summary":"Get Welcome Guide","operationId":"get_welcome_guide_public_v1_properties__property_id__welcome_guide_get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-read":{"summary":"Read a welcome guide","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWelcomeGuide"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.read"]}],"description":"\n\n### Read a welcome guide\nRequired scopes (all): `guides.read`.\n\nReads localized introductions and settings without guide tokens or guest access links.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101/welcome-guide \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"patch":{"tags":["public-api"],"summary":"Update Welcome Guide","operationId":"update_welcome_guide_public_v1_properties__property_id__welcome_guide_patch","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-locales":{"summary":"Update localized guide introductions","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuideUpdate"},"examples":{"guide-locales":{"summary":"Update localized guide introductions","description":"Required scopes (all): guides.write. Omitted locales remain unchanged. Add guides.read to receive guide details.","value":{"intros":{"en":"Welcome! Your practical information is below.","fr":"Bienvenue ! Retrouvez les informations pratiques ci-dessous."}}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicWelcomeGuide"},{"$ref":"#/components/schemas/PublicContentAction"}],"title":"Response Update Welcome Guide Public V1 Properties  Property Id  Welcome Guide Patch"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.write"]}],"description":"\n\n### Update localized guide introductions\nRequired scopes (all): `guides.write`.\n\nOmitted locales remain unchanged. Add guides.read to receive guide details.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/properties/101/welcome-guide \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"intros\": {\n    \"en\": \"Welcome! Your practical information is below.\",\n    \"fr\": \"Bienvenue ! Retrouvez les informations pratiques ci-dessous.\"\n  }\n}'\n```"}},"/public/v1/properties/{property_id}/welcome-guide/pages":{"get":{"tags":["public-api"],"summary":"List Guide Pages","operationId":"list_guide_pages_public_v1_properties__property_id__welcome_guide_pages_get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-pages":{"summary":"List guide pages","value":101}}},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuidePageList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.read"]}],"description":"\n\n### List guide pages\nRequired scopes (all): `guides.read`.\n\nRead page identifiers and ordering before editing.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101/welcome-guide/pages \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"post":{"tags":["public-api"],"summary":"Create Guide Page","operationId":"create_guide_page_public_v1_properties__property_id__welcome_guide_pages_post","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-page-create":{"summary":"Create a structured guide page","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuidePageCreate"},"examples":{"guide-page-create":{"summary":"Create a structured guide page","description":"Required scopes (all): guides.write. Supports start, end or after_page positioning; after_page requires afterPageId. REST validates each block type and its data before saving (422 on failure). Supported types: paragraph, header, quote, list, delimiter, table, image, video, embed, upsellCatalog and upsellProduct. Nested list items are validated; supplied block IDs must be non-empty unique strings. Editor-only imageLibrary blocks are rejected.","value":{"locale":"en","title":"Parking","content":{"blocks":[{"id":"parking-info","type":"paragraph","data":{"text":"Use the <b>marked parking space</b> in the courtyard."}}]},"position":"end"}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicGuidePage"},{"$ref":"#/components/schemas/PublicContentAction"}],"title":"Response Create Guide Page Public V1 Properties  Property Id  Welcome Guide Pages Post"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.write"]}],"description":"\n\n### Create a structured guide page\nRequired scopes (all): `guides.write`.\n\nSupports start, end or after_page positioning; after_page requires afterPageId. REST validates each block type and its data before saving (422 on failure). Supported types: paragraph, header, quote, list, delimiter, table, image, video, embed, upsellCatalog and upsellProduct. Nested list items are validated; supplied block IDs must be non-empty unique strings. Editor-only imageLibrary blocks are rejected.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/properties/101/welcome-guide/pages \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"locale\": \"en\",\n  \"title\": \"Parking\",\n  \"content\": {\n    \"blocks\": [\n      {\n        \"id\": \"parking-info\",\n        \"type\": \"paragraph\",\n        \"data\": {\n          \"text\": \"Use the <b>marked parking space</b> in the courtyard.\"\n        }\n      }\n    ]\n  },\n  \"position\": \"end\"\n}'\n```"}},"/public/v1/properties/{property_id}/welcome-guide/pages/{page_id}":{"get":{"tags":["public-api"],"summary":"Get Guide Page","operationId":"get_guide_page_public_v1_properties__property_id__welcome_guide_pages__page_id__get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-page-read":{"summary":"Read a structured guide page","value":101}}},{"name":"page_id","in":"path","required":true,"schema":{"type":"integer","title":"Page Id"},"examples":{"guide-page-read":{"summary":"Read a structured guide page","value":301}}},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuidePage"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.read"]}],"description":"\n\n### Read a structured guide page\nRequired scopes (all): `guides.read`.\n\nRead content/contents before an edit to preserve EditorJS block IDs, nested formatting and media.\n\n```bash\ncurl -X GET https://api.nowistay.com/public/v1/properties/101/welcome-guide/pages/301 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```"},"patch":{"tags":["public-api"],"summary":"Update Guide Page","operationId":"update_guide_page_public_v1_properties__property_id__welcome_guide_pages__page_id__patch","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-page-update":{"summary":"Edit and position a structured guide page","value":101}}},{"name":"page_id","in":"path","required":true,"schema":{"type":"integer","title":"Page Id"},"examples":{"guide-page-update":{"summary":"Edit and position a structured guide page","value":301}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuidePageUpdate"},"examples":{"guide-page-update":{"summary":"Edit and position a structured guide page","description":"Required scopes (all): guides.write. Start from the existing complete content and keep all unaffected blocks and IDs. This example assumes a page containing the single shown block. Plain-text replacement of structured pages is rejected; omitted locales remain unchanged. Every supplied language is validated before any write: unsupported types, malformed block data and duplicate IDs return 422. Unknown metadata is preserved; IDs remain optional for existing documents. Title/order-only updates do not revalidate untouched content.","value":{"locale":"en","content":{"blocks":[{"id":"parking-info","type":"paragraph","data":{"text":"Use the <b>marked parking space</b> in the courtyard."}}]},"order":2}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicGuidePage"},{"$ref":"#/components/schemas/PublicContentAction"}],"title":"Response Update Guide Page Public V1 Properties  Property Id  Welcome Guide Pages  Page Id  Patch"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.write"]}],"description":"\n\n### Edit and position a structured guide page\nRequired scopes (all): `guides.write`.\n\nStart from the existing complete content and keep all unaffected blocks and IDs. This example assumes a page containing the single shown block. Plain-text replacement of structured pages is rejected; omitted locales remain unchanged. Every supplied language is validated before any write: unsupported types, malformed block data and duplicate IDs return 422. Unknown metadata is preserved; IDs remain optional for existing documents. Title/order-only updates do not revalidate untouched content.\n\n```bash\ncurl -X PATCH https://api.nowistay.com/public/v1/properties/101/welcome-guide/pages/301 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"locale\": \"en\",\n  \"content\": {\n    \"blocks\": [\n      {\n        \"id\": \"parking-info\",\n        \"type\": \"paragraph\",\n        \"data\": {\n          \"text\": \"Use the <b>marked parking space</b> in the courtyard.\"\n        }\n      }\n    ]\n  },\n  \"order\": 2\n}'\n```"}},"/public/v1/properties/{property_id}/welcome-guide/images":{"post":{"tags":["public-api"],"summary":"Create Guide Image","operationId":"create_guide_image_public_v1_properties__property_id__welcome_guide_images_post","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"integer","title":"Property Id"},"examples":{"guide-image-url":{"summary":"Upload a guide image from a public URL","value":101},"guide-image-base64":{"summary":"Upload a base64 guide image","value":101}}},{"name":"automation_cleaning_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Cleaning Service"}},{"name":"automation_service","in":"query","required":false,"schema":{"anyOf":[{},{"type":"null"}],"title":"Automation Service"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuideImageCreate"},"examples":{"guide-image-url":{"summary":"Upload a guide image from a public URL","description":"Required scopes (all): guides.write. Replace this example URL with a real public image. Redirects and destination addresses are checked, with size limits before upload.","value":{"imageUrl":"https://images.example.com/parking.jpg","filename":"parking.jpg","caption":"The marked parking space"}},"guide-image-base64":{"summary":"Upload a base64 guide image","description":"Required scopes (all): guides.write. A small PNG example. filename is required with base64 input; download and decoded image size limits still apply.","value":{"filename":"pixel.png","contentType":"image/png","imageBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="}}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGuideImageCreated"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}},"security":[{"OAuth2":["guides.write"]}],"description":"\n\n### Upload a guide image from a public URL\nRequired scopes (all): `guides.write`.\n\nReplace this example URL with a real public image. Redirects and destination addresses are checked, with size limits before upload.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/properties/101/welcome-guide/images \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"imageUrl\": \"https://images.example.com/parking.jpg\",\n  \"filename\": \"parking.jpg\",\n  \"caption\": \"The marked parking space\"\n}'\n```\n\n### Upload a base64 guide image\nRequired scopes (all): `guides.write`.\n\nA small PNG example. filename is required with base64 input; download and decoded image size limits still apply.\n\n```bash\ncurl -X POST https://api.nowistay.com/public/v1/properties/101/welcome-guide/images \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  --data '{\n  \"filename\": \"pixel.png\",\n  \"contentType\": \"image/png\",\n  \"imageBase64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII=\"\n}'\n```"}},"/.well-known/oauth-authorization-server/public-api":{"get":{"tags":["public-api-oauth"],"summary":"Public Oauth Authorization Server Metadata","operationId":"public_oauth_authorization_server_metadata__well_known_oauth_authorization_server_public_api_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOAuthAuthorizationServerMetadata"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}},"/.well-known/oauth-protected-resource/public-api":{"get":{"tags":["public-api-oauth"],"summary":"Public Oauth Protected Resource Metadata","operationId":"public_oauth_protected_resource_metadata__well_known_oauth_protected_resource_public_api_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOAuthProtectedResourceMetadata"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}},"/public/oauth/authorize":{"get":{"tags":["public-api-oauth"],"summary":"Public Oauth Authorize","operationId":"public_oauth_authorize_public_oauth_authorize_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}},"post":{"tags":["public-api-oauth"],"summary":"Public Oauth Authorize Decision","operationId":"public_oauth_authorize_decision_public_oauth_authorize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthorizeDecisionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthorizeRedirectResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}},"/public/oauth/authorize/context":{"get":{"tags":["public-api-oauth"],"summary":"Public Oauth Authorize Context","operationId":"public_oauth_authorize_context_public_oauth_authorize_context_get","parameters":[{"name":"response_type","in":"query","required":true,"schema":{"type":"string","title":"Response Type"}},{"name":"client_id","in":"query","required":true,"schema":{"type":"string","title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","title":"Redirect Uri"}},{"name":"code_challenge","in":"query","required":true,"schema":{"type":"string","title":"Code Challenge"}},{"name":"code_challenge_method","in":"query","required":true,"schema":{"type":"string","title":"Code Challenge Method"}},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"resource","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthorizationContext"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}},"/public/oauth/token":{"post":{"tags":["public-api-oauth"],"summary":"Public Oauth Token","operationId":"public_oauth_token_public_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTokenResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}},"/public/oauth/register":{"post":{"tags":["public-api-oauth"],"summary":"Public Oauth Register","operationId":"public_oauth_register_public_oauth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDynamicClientRegistrationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDynamicClientRegistrationResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorEnvelope"}}}}}}}},"components":{"schemas":{"AddressUpdate":{"properties":{"line1":{"type":"string","title":"Line1"},"line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line2"},"postalCode":{"type":"string","title":"Postalcode"},"city":{"type":"string","title":"City"},"country":{"type":"string","title":"Country"},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countrycode"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"additionalProperties":false,"type":"object","required":["line1","postalCode","city","country"],"title":"AddressUpdate"},"AssistantThreadChannelKind":{"type":"string","enum":["ota","whatsapp","email","voice"],"title":"AssistantThreadChannelKind"},"BookingChannel":{"type":"string","enum":["airbnb","booking","vrbo","expedia","agoda","direct","other"],"title":"BookingChannel"},"BookingStatus":{"type":"string","enum":["confirmed","pending","cancelled","unavailable"],"title":"BookingStatus"},"ChecklistItemDetailRead":{"properties":{"id":{"type":"integer","title":"Id"},"label":{"type":"string","title":"Label"},"order":{"type":"integer","title":"Order"},"checked":{"type":"boolean","title":"Checked"},"roomType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roomtype"},"roomNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roomnumber"}},"type":"object","required":["id","label","order","checked"],"title":"ChecklistItemDetailRead","description":"Checklist item with completion status for detail view."},"CompletionVideoRead":{"properties":{"url":{"type":"string","title":"Url"},"receivedAt":{"type":"string","format":"date-time","title":"Receivedat"},"stamp":{"type":"string","title":"Stamp"}},"type":"object","required":["url","receivedAt","stamp"],"title":"CompletionVideoRead","description":"A report video and when it reached our storage (`stamp` = that time as shown to the host)."},"MissionStatus":{"type":"string","enum":["pending","pending_host","assigned","in_progress","completed","cancelled","failed"],"title":"MissionStatus"},"MissionType":{"type":"string","enum":["cleaning","maintenance","urgency","custom"],"title":"MissionType"},"PublicActionResult":{"properties":{"id":{"type":"integer","title":"Id"}},"additionalProperties":false,"type":"object","required":["id"],"title":"PublicActionResult"},"PublicActivityEvent":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"},"entityType":{"type":"string","title":"Entitytype"},"entityId":{"type":"integer","title":"Entityid"},"eventType":{"type":"string","title":"Eventtype"},"category":{"type":"string","title":"Category"},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entityname"},"teamMemberName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Teammembername"},"summary":{"type":"string","title":"Summary"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"}},"additionalProperties":false,"type":"object","required":["id","entityType","entityId","eventType","category","summary","createdAt"],"title":"PublicActivityEvent","example":{"category":"booking","createdAt":"2026-05-26T09:12:00Z","entityId":9001,"entityName":"Maya Martin","entityType":"booking","eventType":"updated","id":7001,"propertyId":101,"summary":"booking updated","teamMemberName":"Nora Bernard"}},"PublicAddress":{"properties":{"line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line1"},"line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line2"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postalcode"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Countrycode"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"}},"additionalProperties":false,"type":"object","title":"PublicAddress","example":{"city":"Paris","country":"France","countryCode":"FR","latitude":48.8566,"line1":"12 Rue des Lilas","line2":"Apartment 3B","longitude":2.3522,"postalCode":"75011","timezone":"Europe/Paris"}},"PublicAuthorizationContext":{"properties":{"clientId":{"type":"string","title":"Clientid"},"clientName":{"type":"string","title":"Clientname"},"redirectUri":{"type":"string","title":"Redirecturi"},"scopesRequested":{"items":{"type":"string"},"type":"array","title":"Scopesrequested"},"scopesGranted":{"items":{"type":"string"},"type":"array","title":"Scopesgranted"},"resource":{"type":"string","title":"Resource"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"accessibleAccount":{"additionalProperties":true,"type":"object","title":"Accessibleaccount"},"consentToken":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consenttoken"}},"additionalProperties":false,"type":"object","required":["clientId","clientName","redirectUri","scopesRequested","scopesGranted","resource","accessibleAccount"],"title":"PublicAuthorizationContext","example":{"accessibleAccount":{"email":"host@example.com","id":42,"name":"Claire Dubois","role":"host"},"clientId":"client_2Yw4Rk9pQp","clientName":"Partner PMS","consentToken":"single_use_token_from_authorization_context","redirectUri":"https://partner.example.com/oauth/callback","resource":"https://api.nowistay.com/public/v1","scopesGranted":["properties.read","calendar.read","calendar.write","bookings.read","booking_parameters.read","webhooks.read","webhooks.write"],"scopesRequested":["properties.read","calendar.read","calendar.write","bookings.read","booking_parameters.read","webhooks.read","webhooks.write"],"state":"state_8d7f3"}},"PublicAuthorizeDecisionRequest":{"properties":{"responseType":{"type":"string","title":"Responsetype"},"clientId":{"type":"string","title":"Clientid"},"redirectUri":{"type":"string","title":"Redirecturi"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"codeChallenge":{"type":"string","title":"Codechallenge"},"codeChallengeMethod":{"type":"string","title":"Codechallengemethod"},"resource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource"},"decision":{"type":"string","title":"Decision"},"consentToken":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Consenttoken","description":"Single-use consent token from the authorization context; expires after 10 minutes."}},"additionalProperties":false,"type":"object","required":["responseType","clientId","redirectUri","codeChallenge","codeChallengeMethod","decision"],"title":"PublicAuthorizeDecisionRequest","example":{"clientId":"client_2Yw4Rk9pQp","codeChallenge":"Lq2mX8rL9R1j9x2eY5m4F5xkP4fVqz2gX7n3rQ","codeChallengeMethod":"S256","consentToken":"single_use_token_from_authorization_context","decision":"approve","redirectUri":"https://partner.example.com/oauth/callback","resource":"https://api.nowistay.com/public/v1","responseType":"code","scope":"properties.read calendar.read calendar.write bookings.read booking_parameters.read webhooks.read webhooks.write","state":"state_8d7f3"}},"PublicAuthorizeRedirectResponse":{"properties":{"redirectUri":{"type":"string","title":"Redirecturi"}},"additionalProperties":false,"type":"object","required":["redirectUri"],"title":"PublicAuthorizeRedirectResponse","example":{"redirectUri":"https://partner.example.com/oauth/callback?code=auth_code_123&state=state_8d7f3"}},"PublicBookingAccess":{"properties":{"smartlock":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingAccessSmartlock"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"PublicBookingAccess","example":{"smartlock":{"code":"482913","doors":[{"code":"482913","label":"Building door","position":1}],"status":"available"}}},"PublicBookingAccessDoor":{"properties":{"position":{"type":"integer","title":"Position"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},"additionalProperties":false,"type":"object","required":["position"],"title":"PublicBookingAccessDoor","example":{"code":"482913","label":"Building door","position":1}},"PublicBookingAccessSmartlock":{"properties":{"status":{"type":"string","title":"Status"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"doors":{"items":{"$ref":"#/components/schemas/PublicBookingAccessDoor"},"type":"array","title":"Doors","default":[]}},"additionalProperties":false,"type":"object","required":["status"],"title":"PublicBookingAccessSmartlock","example":{"code":"482913","doors":[{"code":"482913","label":"Building door","position":1}],"status":"available"}},"PublicBookingAmounts":{"properties":{"amount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"accommodationAmount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Accommodationamount"},"cleaningAmount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Cleaningamount"},"regulatoryTax":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Regulatorytax"},"nightRate":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Nightrate"},"otaCommission":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Otacommission"}},"additionalProperties":false,"type":"object","title":"PublicBookingAmounts","example":{"accommodationAmount":"546.60","amount":"620.00","cleaningAmount":"55.00","currency":"EUR","nightRate":"136.65","otaCommission":"42.00","regulatoryTax":"18.40"}},"PublicBookingCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid"},"arrival":{"type":"string","format":"date","title":"Arrival"},"departure":{"type":"string","format":"date","title":"Departure"},"checkIn":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkin"},"checkOut":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkout"},"guestName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestname"},"guestFirstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestfirstname"},"guestLastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestlastname"},"guestEmail":{"type":"string","title":"Guestemail"},"guestPhone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestphone"},"adults":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Adults"},"children":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Children"},"status":{"$ref":"#/components/schemas/BookingStatus","default":"confirmed"},"amount":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amount"},"cleaningAmount":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Cleaningamount"},"regulatoryTax":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Regulatorytax"},"nightRate":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Nightrate"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"silent":{"type":"boolean","title":"Silent","default":false},"requestPayment":{"type":"boolean","title":"Requestpayment","default":false}},"additionalProperties":false,"type":"object","required":["propertyId","arrival","departure","guestEmail"],"title":"PublicBookingCreate","example":{"adults":2,"amount":"240.00","arrival":"2026-10-10","currency":"EUR","departure":"2026-10-12","guestEmail":"maya@example.com","guestFirstName":"Maya","propertyId":1,"requestPayment":false}},"PublicBookingCreateResponse":{"properties":{"booking":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingDetail"},{"$ref":"#/components/schemas/PublicActionResult"}],"title":"Booking"},"paymentRequest":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingPaymentResult"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["booking"],"title":"PublicBookingCreateResponse"},"PublicBookingDeposit":{"properties":{"status":{"type":"string","title":"Status"},"paid":{"type":"boolean","title":"Paid"},"amount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"dueAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Dueat"},"releaseAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Releaseat"}},"additionalProperties":false,"type":"object","required":["status","paid"],"title":"PublicBookingDeposit","example":{"amount":"350.00","currency":"EUR","dueAt":"2026-07-12T16:00:00Z","paid":true,"releaseAt":"2026-07-20T11:00:00Z","status":"authorized"}},"PublicBookingDetail":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"arrival":{"type":"string","format":"date","title":"Arrival"},"departure":{"type":"string","format":"date","title":"Departure"},"checkIn":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkin"},"checkOut":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkout"},"nights":{"type":"integer","title":"Nights"},"status":{"anyOf":[{"$ref":"#/components/schemas/BookingStatus"},{"type":"null"}]},"channel":{"anyOf":[{"$ref":"#/components/schemas/BookingChannel"},{"type":"null"}]},"reservationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reservationnumber"},"guest":{"$ref":"#/components/schemas/PublicGuestDetail"},"amounts":{"$ref":"#/components/schemas/PublicBookingAmounts"},"adults":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Adults"},"children":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Children"},"directBooking":{"type":"boolean","title":"Directbooking"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"},"access":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingAccess"},{"type":"null"}]},"identity":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingStatusInfo"},{"type":"null"}]},"deposit":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingDeposit"},{"type":"null"}]},"customParameters":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Customparameters"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"additionalProperties":false,"type":"object","required":["id","propertyId","arrival","departure","nights","guest","amounts","directBooking"],"title":"PublicBookingDetail","example":{"access":{"smartlock":{"code":"482913","doors":[{"code":"482913","label":"Building door","position":1}],"status":"available"}},"adults":2,"amounts":{"accommodationAmount":"546.60","amount":"620.00","cleaningAmount":"55.00","currency":"EUR","nightRate":"136.65","otaCommission":"42.00","regulatoryTax":"18.40"},"arrival":"2026-07-14","channel":"direct","checkIn":"16:00:00","checkOut":"11:00:00","children":1,"createdAt":"2026-05-20T10:15:00Z","customParameters":{"external_status":"ready","screening_step":"approved"},"departure":"2026-07-18","deposit":{"amount":"350.00","currency":"EUR","dueAt":"2026-07-12T16:00:00Z","paid":true,"releaseAt":"2026-07-20T11:00:00Z","status":"authorized"},"directBooking":true,"guest":{"address":"8 Avenue Victor Hugo","city":"Lyon","country":"FR","email":"maya.martin@example.com","firstName":"Maya","fullName":"Maya Martin","language":"fr","lastName":"Martin","phone":"+33612345678","postalCode":"69002"},"id":9001,"identity":{"status":"verified"},"nights":4,"notes":"Guest requested a baby cot.","propertyId":101,"reservationNumber":"NST-2026-00042","status":"confirmed","updatedAt":"2026-05-26T08:45:00Z"}},"PublicBookingListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicBookingSummary"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicBookingListResponse","example":{"data":[{"adults":2,"amounts":{"accommodationAmount":"546.60","amount":"620.00","cleaningAmount":"55.00","currency":"EUR","nightRate":"136.65","otaCommission":"42.00","regulatoryTax":"18.40"},"arrival":"2026-07-14","channel":"direct","checkIn":"16:00:00","checkOut":"11:00:00","children":1,"createdAt":"2026-05-20T10:15:00Z","departure":"2026-07-18","directBooking":true,"guest":{"firstName":"Maya","fullName":"Maya Martin","lastName":"Martin"},"id":9001,"nights":4,"propertyId":101,"reservationNumber":"NST-2026-00042","status":"confirmed","updatedAt":"2026-05-26T08:45:00Z"}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicBookingParameter":{"properties":{"key":{"type":"string","title":"Key"},"name":{"type":"string","title":"Name"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["key","name","createdAt","updatedAt"],"title":"PublicBookingParameter","example":{"createdAt":"2026-05-20T10:00:00Z","key":"external_status","name":"External status","updatedAt":"2026-05-20T10:00:00Z"}},"PublicBookingParameterCreate":{"properties":{"key":{"type":"string","title":"Key"},"name":{"type":"string","title":"Name"}},"additionalProperties":false,"type":"object","required":["key","name"],"title":"PublicBookingParameterCreate","example":{"key":"external_status","name":"External status"}},"PublicBookingParameterUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"additionalProperties":false,"type":"object","title":"PublicBookingParameterUpdate","example":{"name":"Partner status"}},"PublicBookingPatch":{"properties":{"arrival":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Arrival"},"departure":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Departure"},"checkIn":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkin"},"checkOut":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkout"},"guestFirstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestfirstname"},"guestLastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestlastname"},"guestEmail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestemail"},"guestPhone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestphone"},"adults":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Adults"},"children":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Children"},"status":{"anyOf":[{"$ref":"#/components/schemas/BookingStatus"},{"type":"null"}]},"amount":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amount"},"cleaningAmount":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Cleaningamount"},"regulatoryTax":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Regulatorytax"},"nightRate":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Nightrate"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postalcode"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"silent":{"type":"boolean","title":"Silent","default":true},"customParameters":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Customparameters"},"reservationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reservationnumber"},"cancellationRefundMode":{"anyOf":[{"$ref":"#/components/schemas/RefundMode"},{"type":"null"}]},"cancellationRefundAmount":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Cancellationrefundamount"}},"additionalProperties":false,"type":"object","title":"PublicBookingPatch","example":{"address":"8 Avenue Victor Hugo","adults":2,"amount":"620.00","arrival":"2026-07-14","checkIn":"16:00:00","checkOut":"11:00:00","children":1,"city":"Lyon","cleaningAmount":"55.00","country":"FR","currency":"EUR","customParameters":{"external_status":"ready"},"departure":"2026-07-18","guestEmail":"maya.martin@example.com","guestFirstName":"Maya","guestLastName":"Martin","guestPhone":"+33612345678","language":"fr","nightRate":"136.65","notes":"Guest requested a baby cot.","postalCode":"69002","regulatoryTax":"18.40","silent":true,"status":"confirmed"}},"PublicBookingPaymentRequest":{"properties":{"bookingType":{"type":"string","enum":["manual","ota","direct"],"title":"Bookingtype"},"paymentRequest":{"anyOf":[{"$ref":"#/components/schemas/PublicBookingPaymentStatus"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["bookingType"],"title":"PublicBookingPaymentRequest"},"PublicBookingPaymentResult":{"properties":{"requested":{"type":"boolean","title":"Requested"},"sent":{"type":"boolean","title":"Sent"},"checkoutUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkouturl"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"additionalProperties":false,"type":"object","required":["requested","sent"],"title":"PublicBookingPaymentResult"},"PublicBookingPaymentStatus":{"properties":{"status":{"type":"string","title":"Status"},"source":{"type":"string","title":"Source","description":"widget (the booking widget), host (a payment link the host sent) or website (booked on the host's Nowistay website)"},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promocode","description":"The promo code the guest used on the booking widget, if any"},"promoCodeAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Promocodeamount","description":"The amount the promo code took off the stay, in the booking's currency"}},"additionalProperties":false,"type":"object","required":["status","source"],"title":"PublicBookingPaymentStatus"},"PublicBookingStatusInfo":{"properties":{"status":{"type":"string","title":"Status"}},"additionalProperties":false,"type":"object","required":["status"],"title":"PublicBookingStatusInfo","example":{"status":"verified"}},"PublicBookingSummary":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"arrival":{"type":"string","format":"date","title":"Arrival"},"departure":{"type":"string","format":"date","title":"Departure"},"checkIn":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkin"},"checkOut":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkout"},"nights":{"type":"integer","title":"Nights"},"status":{"anyOf":[{"$ref":"#/components/schemas/BookingStatus"},{"type":"null"}]},"channel":{"anyOf":[{"$ref":"#/components/schemas/BookingChannel"},{"type":"null"}]},"reservationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reservationnumber"},"guest":{"$ref":"#/components/schemas/PublicGuestSummary"},"amounts":{"$ref":"#/components/schemas/PublicBookingAmounts"},"adults":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Adults"},"children":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Children"},"directBooking":{"type":"boolean","title":"Directbooking"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","propertyId","arrival","departure","nights","guest","amounts","directBooking"],"title":"PublicBookingSummary","example":{"adults":2,"amounts":{"accommodationAmount":"546.60","amount":"620.00","cleaningAmount":"55.00","currency":"EUR","nightRate":"136.65","otaCommission":"42.00","regulatoryTax":"18.40"},"arrival":"2026-07-14","channel":"direct","checkIn":"16:00:00","checkOut":"11:00:00","children":1,"createdAt":"2026-05-20T10:15:00Z","departure":"2026-07-18","directBooking":true,"guest":{"firstName":"Maya","fullName":"Maya Martin","lastName":"Martin"},"id":9001,"nights":4,"propertyId":101,"reservationNumber":"NST-2026-00042","status":"confirmed","updatedAt":"2026-05-26T08:45:00Z"}},"PublicCalendarAppliedUpdate":{"properties":{"availability":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Availability","description":"Applied inventory value: 0 closed or 1 open."},"rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate","description":"Applied nightly rate."},"minStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minstay","description":"Applied minimum stay in nights."},"maxStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxstay","description":"Applied maximum stay in nights."},"stopSell":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stopsell","description":"Applied sales closure."},"closedToArrival":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Closedtoarrival","description":"Applied check-in restriction."},"closedToDeparture":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Closedtodeparture","description":"Applied check-out restriction."},"daysOfWeek":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Daysofweek","description":"Normalized weekdays changed in the range."},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Applied note; an empty string means the note was cleared."}},"additionalProperties":false,"type":"object","title":"PublicCalendarAppliedUpdate","example":{"availability":1,"closedToArrival":false,"closedToDeparture":false,"daysOfWeek":[0,1,2,3,4],"maxStay":14,"minStay":2,"note":"Family staying","rate":145.0,"stopSell":false}},"PublicCalendarDay":{"properties":{"date":{"type":"string","format":"date","title":"Date","description":"Calendar date in the property's local timezone."},"availability":{"type":"integer","title":"Availability","description":"Remaining sellable inventory after confirmed bookings."},"rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate","description":"Nightly rate in the response currency."},"minStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minstay","description":"Minimum stay in nights for an arrival on this date."},"maxStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxstay","description":"Maximum stay in nights for an arrival on this date."},"stopSell":{"type":"boolean","title":"Stopsell","description":"Whether sales are stopped for this night."},"closedToArrival":{"type":"boolean","title":"Closedtoarrival","description":"Whether check-in is forbidden on this date."},"closedToDeparture":{"type":"boolean","title":"Closedtodeparture","description":"Whether check-out is forbidden on this date."},"restricted":{"type":"boolean","title":"Restricted","description":"Whether another effective rule prevents a valid stay starting on this date."},"restrictionReasons":{"items":{"$ref":"#/components/schemas/PublicCalendarRestriction"},"type":"array","title":"Restrictionreasons","description":"Public-safe reasons for an effective restriction."},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"The host's private note on this night, null when none. Never sent to guests or booking channels."}},"additionalProperties":false,"type":"object","required":["date","availability","stopSell","closedToArrival","closedToDeparture","restricted","restrictionReasons"],"title":"PublicCalendarDay","example":{"availability":1,"closedToArrival":false,"closedToDeparture":false,"date":"2026-12-18","maxStay":14,"minStay":2,"note":"Family staying","rate":145.0,"restricted":true,"restrictionReasons":[{"code":"cut_off","scope":"checkIn","value":1}],"stopSell":false}},"PublicCalendarPatch":{"properties":{"from":{"type":"string","format":"date","title":"From","description":"Inclusive first date to update."},"to":{"type":"string","format":"date","title":"To","description":"Inclusive last date to update."},"availability":{"anyOf":[{"type":"integer","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Availability","description":"0 closes a night; 1 opens unsold inventory."},"rate":{"anyOf":[{"type":"number","maximum":99999999.9999,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Rate","description":"Nightly rate in the property's currency."},"minStay":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Minstay","description":"Minimum stay in nights."},"maxStay":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Maxstay","description":"Maximum stay in nights."},"stopSell":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stopsell","description":"Whether to stop selling the selected nights."},"closedToArrival":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Closedtoarrival","description":"Whether to forbid check-in on selected dates."},"closedToDeparture":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Closedtodeparture","description":"Whether to forbid check-out on selected dates."},"daysOfWeek":{"anyOf":[{"items":{"type":"integer","maximum":6.0,"minimum":0.0},"type":"array","maxItems":7,"minItems":1},{"type":"null"}],"title":"Daysofweek","description":"Optional weekdays inside the range: 0=Monday through 6=Sunday. Omit this field to update every date."},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note","description":"Private host note on the selected nights, never sent to guests or booking channels. An empty string clears it; omit this field to keep each night's note."}},"additionalProperties":false,"type":"object","required":["from","to"],"title":"PublicCalendarPatch","example":{"availability":1,"closedToArrival":false,"closedToDeparture":false,"daysOfWeek":[0,1,2,3,4],"from":"2026-12-18","maxStay":14,"minStay":2,"note":"Family staying","rate":145.0,"stopSell":false,"to":"2026-12-31"}},"PublicCalendarResponse":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","description":"Property whose calendar is returned."},"from":{"type":"string","format":"date","title":"From","description":"Inclusive first date returned."},"to":{"type":"string","format":"date","title":"To","description":"Inclusive last date returned."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO 4217 currency used by every rate in days."},"days":{"items":{"$ref":"#/components/schemas/PublicCalendarDay"},"type":"array","title":"Days","description":"One calendar entry for every date in the inclusive range."}},"additionalProperties":false,"type":"object","required":["propertyId","from","to","days"],"title":"PublicCalendarResponse","example":{"currency":"EUR","days":[{"availability":1,"closedToArrival":false,"closedToDeparture":false,"date":"2026-12-18","maxStay":14,"minStay":2,"note":"Family staying","rate":145.0,"restricted":true,"restrictionReasons":[{"code":"cut_off","scope":"checkIn","value":1}],"stopSell":false}],"from":"2026-12-18","propertyId":101,"to":"2026-12-20"}},"PublicCalendarRestriction":{"properties":{"code":{"type":"string","enum":["booking_lead_time","closed_to_arrival","closed_to_departure","cut_off","max_days_notice","max_stay","min_stay","other","turnover_days","weekday_check_in_disabled","weekday_check_out_disabled"],"title":"Code","description":"Stable public code describing the effective restriction."},"scope":{"type":"string","enum":["night","checkIn","checkOut","stay"],"title":"Scope","description":"Part of a stay affected by the restriction."},"value":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value","description":"Numeric rule value when the restriction has one."}},"additionalProperties":false,"type":"object","required":["code","scope"],"title":"PublicCalendarRestriction","example":{"code":"cut_off","scope":"checkIn","value":1}},"PublicCalendarUpdateResponse":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","description":"Property whose calendar was updated."},"from":{"type":"string","format":"date","title":"From","description":"Inclusive first date considered."},"to":{"type":"string","format":"date","title":"To","description":"Inclusive last date considered."},"daysUpdated":{"type":"integer","title":"Daysupdated","description":"Number of dates matching the range and weekday filter."},"appliedUpdate":{"$ref":"#/components/schemas/PublicCalendarAppliedUpdate","description":"Normalized fields applied to matching dates."}},"additionalProperties":false,"type":"object","required":["propertyId","from","to","daysUpdated","appliedUpdate"],"title":"PublicCalendarUpdateResponse","example":{"appliedUpdate":{"availability":1,"closedToArrival":false,"closedToDeparture":false,"daysOfWeek":[0,1,2,3,4],"maxStay":14,"minStay":2,"note":"Family staying","rate":145.0,"stopSell":false},"daysUpdated":10,"from":"2026-12-18","propertyId":101,"to":"2026-12-31"}},"PublicContentAction":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"}},"type":"object","required":["id","propertyId"],"title":"PublicContentAction"},"PublicConversation":{"properties":{"conversationId":{"type":"integer","title":"Conversationid"},"bookingId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"},"propertyId":{"type":"integer","title":"Propertyid"},"guestName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guestname"},"arrival":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Arrival"},"departure":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Departure"},"reservationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reservationnumber"},"channel":{"type":"string","title":"Channel"},"lastMessageAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Lastmessageat"},"lastMessageRole":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastmessagerole"},"lastMessageStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastmessagestatus"},"isInquiry":{"type":"boolean","title":"Isinquiry","default":false}},"type":"object","required":["conversationId","propertyId","channel"],"title":"PublicConversation"},"PublicConversationList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicConversation"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"type":"object","required":["data","pagination"],"title":"PublicConversationList"},"PublicConversationMessage":{"properties":{"id":{"type":"integer","title":"Id"},"role":{"type":"string","title":"Role"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"fromName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fromname"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"channelKind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channelkind"},"deliveryError":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deliveryerror"}},"type":"object","required":["id","role","status","message"],"title":"PublicConversationMessage"},"PublicDynamicClientRegistrationRequest":{"properties":{"clientName":{"type":"string","title":"Clientname"},"redirectUris":{"items":{"type":"string"},"type":"array","title":"Redirecturis"},"grantTypes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Granttypes"},"responseTypes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Responsetypes"},"tokenEndpointAuthMethod":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tokenendpointauthmethod"},"scope":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scope"},"clientUri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clienturi"}},"type":"object","required":["clientName","redirectUris"],"title":"PublicDynamicClientRegistrationRequest","example":{"clientName":"Partner PMS","clientUri":"https://partner.example.com","grantTypes":["authorization_code","refresh_token"],"redirectUris":["https://partner.example.com/oauth/callback"],"responseTypes":["code"],"scope":"properties.read calendar.read calendar.write bookings.read booking_parameters.read webhooks.read webhooks.write","tokenEndpointAuthMethod":"client_secret_post"}},"PublicDynamicClientRegistrationResponse":{"properties":{"client_id":{"type":"string","title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret"},"client_id_issued_at":{"type":"integer","title":"Client Id Issued At"},"client_secret_expires_at":{"type":"integer","title":"Client Secret Expires At"},"client_name":{"type":"string","title":"Client Name"},"redirect_uris":{"items":{"type":"string"},"type":"array","title":"Redirect Uris"},"grant_types":{"items":{"type":"string"},"type":"array","title":"Grant Types"},"response_types":{"items":{"type":"string"},"type":"array","title":"Response Types"},"token_endpoint_auth_method":{"type":"string","title":"Token Endpoint Auth Method"},"scope":{"type":"string","title":"Scope"},"client_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Uri"}},"additionalProperties":false,"type":"object","required":["client_id","client_id_issued_at","client_secret_expires_at","client_name","redirect_uris","grant_types","response_types","token_endpoint_auth_method","scope"],"title":"PublicDynamicClientRegistrationResponse","example":{"client_id":"client_2Yw4Rk9pQp","client_id_issued_at":1771945200,"client_name":"Partner PMS","client_secret":"client_secret_example","client_secret_expires_at":0,"client_uri":"https://partner.example.com","grant_types":["authorization_code","refresh_token"],"redirect_uris":["https://partner.example.com/oauth/callback"],"response_types":["code"],"scope":"properties.read calendar.read calendar.write bookings.read booking_parameters.read webhooks.read webhooks.write","token_endpoint_auth_method":"client_secret_post"}},"PublicErrorDetail":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"requestId":{"type":"string","title":"Requestid"}},"additionalProperties":false,"type":"object","required":["code","message","requestId"],"title":"PublicErrorDetail","example":{"code":"validation_error","message":"Parameter key must be lowercase snake_case, start with a letter, and be at most 40 characters","requestId":"req_01HYZV5R8G3W9Y2M7K4P6Q1N2A"}},"PublicErrorEnvelope":{"properties":{"error":{"$ref":"#/components/schemas/PublicErrorDetail"}},"additionalProperties":false,"type":"object","required":["error"],"title":"PublicErrorEnvelope","example":{"error":{"code":"validation_error","message":"Parameter key must be lowercase snake_case, start with a letter, and be at most 40 characters","requestId":"req_01HYZV5R8G3W9Y2M7K4P6Q1N2A"}}},"PublicGuestCreate":{"properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"fullName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fullname"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},"additionalProperties":false,"type":"object","title":"PublicGuestCreate"},"PublicGuestDetail":{"properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"fullName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fullname"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postalcode"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},"additionalProperties":false,"type":"object","title":"PublicGuestDetail","example":{"address":"8 Avenue Victor Hugo","city":"Lyon","country":"FR","email":"maya.martin@example.com","firstName":"Maya","fullName":"Maya Martin","language":"fr","lastName":"Martin","phone":"+33612345678","postalCode":"69002"}},"PublicGuestProfile":{"properties":{"id":{"type":"integer","title":"Id"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"fullName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fullname"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postalcode"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"bookingsCount":{"type":"integer","title":"Bookingscount","default":0},"totalAmount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Totalamount"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"lastStay":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Laststay"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","createdAt","updatedAt"],"title":"PublicGuestProfile","description":"A guest (customer) from the owner's deduplicated guest base.\n\nGuests are owner-level: the customer base spans all of the owner's\nproperties (a returning guest staying at two properties is one record).","example":{"address":"12 Rue des Lilas","bookingsCount":3,"city":"Paris","country":"FR","createdAt":"2026-01-18T08:00:00Z","currency":"EUR","email":"marie.durand@example.com","firstName":"Marie","fullName":"Marie Durand","id":701,"language":"fr","lastName":"Durand","lastStay":"2026-05-12","notes":"Prefers late checkout","phone":"+33612345678","postalCode":"75011","totalAmount":"1240.50","updatedAt":"2026-05-25T17:30:00Z"}},"PublicGuestProfileListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicGuestProfile"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicGuestProfileListResponse","example":{"data":[{"address":"12 Rue des Lilas","bookingsCount":3,"city":"Paris","country":"FR","createdAt":"2026-01-18T08:00:00Z","currency":"EUR","email":"marie.durand@example.com","firstName":"Marie","fullName":"Marie Durand","id":701,"language":"fr","lastName":"Durand","lastStay":"2026-05-12","notes":"Prefers late checkout","phone":"+33612345678","postalCode":"75011","totalAmount":"1240.50","updatedAt":"2026-05-25T17:30:00Z"}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicGuestSummary":{"properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"fullName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fullname"}},"additionalProperties":false,"type":"object","title":"PublicGuestSummary","example":{"firstName":"Maya","fullName":"Maya Martin","lastName":"Martin"}},"PublicGuideImage":{"properties":{"url":{"type":"string","title":"Url"},"filename":{"type":"string","title":"Filename"},"contentType":{"type":"string","title":"Contenttype"},"size":{"type":"integer","title":"Size"},"originalSize":{"type":"integer","title":"Originalsize"},"optimized":{"type":"boolean","title":"Optimized"}},"type":"object","required":["url","filename","contentType","size","originalSize","optimized"],"title":"PublicGuideImage"},"PublicGuideImageCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","default":0},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Direct public HTTPS image URL on port 443 or 80, without credentials; at most three public HTTPS redirects and 10 MB."},"image_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Base64"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"with_border":{"type":"boolean","title":"With Border","default":false},"with_background":{"type":"boolean","title":"With Background","default":false},"stretched":{"type":"boolean","title":"Stretched","default":false}},"additionalProperties":false,"type":"object","title":"PublicGuideImageCreate"},"PublicGuideImageCreated":{"properties":{"propertyId":{"type":"integer","title":"Propertyid"},"image":{"$ref":"#/components/schemas/PublicGuideImage"},"editorJsImageBlock":{"additionalProperties":true,"type":"object","title":"Editorjsimageblock"}},"type":"object","required":["propertyId","image","editorJsImageBlock"],"title":"PublicGuideImageCreated"},"PublicGuidePage":{"properties":{"id":{"type":"integer","title":"Id"},"welcomeBookId":{"type":"integer","title":"Welcomebookid"},"icon":{"type":"string","title":"Icon"},"order":{"type":"integer","title":"Order"},"primaryLocale":{"type":"string","title":"Primarylocale"},"title":{"type":"string","title":"Title"},"text":{"type":"string","title":"Text"},"titles":{"additionalProperties":{"type":"string"},"type":"object","title":"Titles","default":{}},"texts":{"additionalProperties":{"type":"string"},"type":"object","title":"Texts","default":{}},"content":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content"},"contents":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Contents"},"simpleTextUpdateAllowed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Simpletextupdateallowed"},"recommendedUpdateMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendedupdatemode"},"recommendedUpdateField":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendedupdatefield"}},"type":"object","required":["id","welcomeBookId","icon","order","primaryLocale","title","text"],"title":"PublicGuidePage"},"PublicGuidePageCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","default":0},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"icon":{"type":"string","title":"Icon","default":"info"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"titles":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Titles"},"content":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content"},"contents":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Contents"},"position":{"type":"string","title":"Position","default":"end"},"after_page_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"After Page Id"}},"additionalProperties":false,"type":"object","title":"PublicGuidePageCreate"},"PublicGuidePageList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicGuidePage"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"type":"object","required":["data","pagination"],"title":"PublicGuidePageList"},"PublicGuidePageUpdate":{"properties":{"propertyId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Propertyid"},"pageId":{"type":"integer","title":"Pageid","default":0},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"titles":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Titles"},"texts":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Texts"},"content":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content"},"contents":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Contents"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"}},"additionalProperties":false,"type":"object","title":"PublicGuidePageUpdate"},"PublicGuideUpdate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","default":0},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"primary_locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Locale"},"intro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intro"},"intros":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Intros"},"active_locales":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Active Locales"},"activate_locales":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Activate Locales"},"deactivate_locales":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Deactivate Locales"}},"additionalProperties":false,"type":"object","title":"PublicGuideUpdate"},"PublicKnowledgeCopy":{"properties":{"sourcePropertyId":{"type":"integer","title":"Sourcepropertyid","default":0},"targetPropertyIds":{"items":{"type":"integer"},"type":"array","title":"Targetpropertyids"},"questionIds":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Questionids"}},"additionalProperties":false,"type":"object","required":["targetPropertyIds"],"title":"PublicKnowledgeCopy"},"PublicKnowledgeCopyResult":{"properties":{"sourcePropertyId":{"type":"integer","title":"Sourcepropertyid"},"targetResults":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Targetresults"}},"type":"object","required":["sourcePropertyId","targetResults"],"title":"PublicKnowledgeCopyResult"},"PublicKnowledgeCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","default":0},"question":{"type":"string","title":"Question"},"answer":{"type":"string","title":"Answer"},"needHost":{"type":"boolean","title":"Needhost","default":false}},"additionalProperties":false,"type":"object","required":["question","answer"],"title":"PublicKnowledgeCreate"},"PublicKnowledgeList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicKnowledgeQuestion"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"type":"object","required":["data","pagination"],"title":"PublicKnowledgeList"},"PublicKnowledgeQuestion":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"question":{"type":"string","title":"Question"},"answer":{"type":"string","title":"Answer"},"needHost":{"type":"boolean","title":"Needhost"},"autoGenerated":{"type":"boolean","title":"Autogenerated"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"}},"type":"object","required":["id","propertyId","question","answer","needHost","autoGenerated"],"title":"PublicKnowledgeQuestion"},"PublicKnowledgeUpdate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid","default":0},"questionId":{"type":"integer","title":"Questionid","default":0},"question":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Question"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer"},"needHost":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Needhost"}},"additionalProperties":false,"type":"object","title":"PublicKnowledgeUpdate"},"PublicMessageAction":{"properties":{"id":{"type":"integer","title":"Id"},"conversationId":{"type":"integer","title":"Conversationid"},"status":{"type":"string","title":"Status"},"deliverySuccess":{"type":"boolean","title":"Deliverysuccess"}},"type":"object","required":["id","conversationId","status","deliverySuccess"],"title":"PublicMessageAction"},"PublicMessageChannel":{"properties":{"id":{"type":"integer","title":"Id"},"kind":{"type":"string","title":"Kind"},"displayName":{"type":"string","title":"Displayname"},"isDeliverable":{"type":"boolean","title":"Isdeliverable"},"deliverabilityError":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deliverabilityerror"}},"type":"object","required":["id","kind","displayName","isDeliverable"],"title":"PublicMessageChannel"},"PublicMessageCreate":{"properties":{"message":{"type":"string","title":"Message"},"conversationId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conversationid"},"bookingId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"},"threadChannelId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Threadchannelid"},"channelKind":{"anyOf":[{"$ref":"#/components/schemas/AssistantThreadChannelKind"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["message"],"title":"PublicMessageCreate"},"PublicMessageCreated":{"properties":{"message":{"$ref":"#/components/schemas/PublicConversationMessage"},"conversationId":{"type":"integer","title":"Conversationid"},"delivery":{"$ref":"#/components/schemas/PublicMessageDelivery"}},"type":"object","required":["message","conversationId","delivery"],"title":"PublicMessageCreated"},"PublicMessageDelivery":{"properties":{"success":{"type":"boolean","title":"Success"},"externalMessageId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Externalmessageid"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"selectedChannel":{"$ref":"#/components/schemas/PublicMessageChannel"}},"type":"object","required":["success","selectedChannel"],"title":"PublicMessageDelivery"},"PublicMessageList":{"properties":{"conversation":{"$ref":"#/components/schemas/PublicConversation"},"data":{"items":{"$ref":"#/components/schemas/PublicConversationMessage"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"type":"object","required":["conversation","data","pagination"],"title":"PublicMessageList"},"PublicMission":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"bookingId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"},"missionType":{"$ref":"#/components/schemas/MissionType"},"status":{"$ref":"#/components/schemas/MissionStatus"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduledat"},"scheduledTimezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduledtimezone"},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Startedat"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completedat"},"durationMinutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Durationminutes"},"assignedTeamMemberId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Assignedteammemberid"},"assignedTeamMemberName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignedteammembername"},"propertyName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Propertyname"},"payAmount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Payamount","description":"Amount paid to the team member for this mission, excluding tax: the amount set on the mission, else, while a cleaning is not completed, the property price or the member's usual amount."},"invoiced":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Invoiced","description":"True once the mission is in a validated team member invoice: amount, status and assignee are locked."},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","propertyId","missionType","status"],"title":"PublicMission","example":{"assignedTeamMemberId":301,"assignedTeamMemberName":"Nora Bernard","bookingId":9001,"completedAt":"2026-07-18T13:05:00Z","createdAt":"2026-05-22T12:00:00Z","description":"Prepare the apartment for the next guest.","durationMinutes":90,"id":501,"missionType":"cleaning","propertyId":101,"propertyName":"Lilas Apartment","scheduledAt":"2026-07-18T11:30:00Z","scheduledTimezone":"Europe/Paris","startedAt":"2026-07-18T11:35:00Z","status":"assigned","title":"Checkout cleaning","updatedAt":"2026-07-18T13:05:00Z"}},"PublicMissionCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid"},"bookingId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookingid"},"missionType":{"$ref":"#/components/schemas/MissionType"},"status":{"$ref":"#/components/schemas/MissionStatus","default":"pending"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduledat"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"assignedTeamMemberId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Assignedteammemberid","description":"Assign this direct mission to a specific team member. Omit or send null to leave it in pending_host for manual host assignment; automation routing is not available through the Public API."},"silentUpdate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Silentupdate"},"payAmount":{"anyOf":[{"type":"number","maximum":99999999.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Payamount","description":"Amount paid to the team member for this mission, excluding tax, in the property's currency. Omit to leave it unset: a cleaning then follows the price set on the property, else the member's usual amount, until it is completed."}},"additionalProperties":false,"type":"object","required":["propertyId","missionType"],"title":"PublicMissionCreate","example":{"assignedTeamMemberId":301,"bookingId":9001,"description":"Prepare the apartment for the next guest.","missionType":"cleaning","propertyId":101,"scheduledAt":"2026-07-18T11:30:00Z","silentUpdate":false,"status":"pending","timezone":"Europe/Paris","title":"Checkout cleaning"}},"PublicMissionListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicMission"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicMissionListResponse","example":{"data":[{"assignedTeamMemberId":301,"assignedTeamMemberName":"Nora Bernard","bookingId":9001,"completedAt":"2026-07-18T13:05:00Z","createdAt":"2026-05-22T12:00:00Z","description":"Prepare the apartment for the next guest.","durationMinutes":90,"id":501,"missionType":"cleaning","propertyId":101,"propertyName":"Lilas Apartment","scheduledAt":"2026-07-18T11:30:00Z","scheduledTimezone":"Europe/Paris","startedAt":"2026-07-18T11:35:00Z","status":"assigned","title":"Checkout cleaning","updatedAt":"2026-07-18T13:05:00Z"}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicMissionPatch":{"properties":{"status":{"anyOf":[{"$ref":"#/components/schemas/MissionStatus"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduledat"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Startedat"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completedat"},"durationMinutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Durationminutes"},"assignedTeamMemberId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Assignedteammemberid","description":"Omit to preserve the current assignment, provide an ID to assign directly, or send null to clear the assignment and move the mission to pending_host."},"silentUpdate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Silentupdate"},"payAmount":{"anyOf":[{"type":"number","maximum":99999999.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Payamount","description":"Amount paid to the team member for this mission, excluding tax. Omit to preserve it, send a number to set it, or null to clear it. Refused (400 MISSION_INVOICED_LOCKED) once the mission is in a validated team member invoice, as are status and assignee changes."}},"additionalProperties":false,"type":"object","title":"PublicMissionPatch","example":{"assignedTeamMemberId":301,"completedAt":"2026-07-18T12:10:00Z","description":"Guest left early, cleaning can start sooner.","durationMinutes":90,"scheduledAt":"2026-07-18T10:30:00Z","silentUpdate":true,"startedAt":"2026-07-18T10:40:00Z","status":"in_progress","timezone":"Europe/Paris","title":"Checkout cleaning"}},"PublicMissionReport":{"properties":{"id":{"type":"integer","title":"Id"},"missionId":{"type":"integer","title":"Missionid"},"completedByTeamMemberId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completedbyteammemberid"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment"},"photos":{"items":{"type":"string"},"type":"array","title":"Photos"},"videos":{"items":{"$ref":"#/components/schemas/CompletionVideoRead"},"type":"array","title":"Videos","default":[]},"checklistItems":{"items":{"$ref":"#/components/schemas/ChecklistItemDetailRead"},"type":"array","title":"Checklistitems"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"},"completedByTeamMemberName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completedbyteammembername"}},"type":"object","required":["id","missionId","completedByTeamMemberId","comment","photos","checklistItems","createdAt","updatedAt"],"title":"PublicMissionReport"},"PublicMissionReportResponse":{"properties":{"missionId":{"type":"integer","title":"Missionid"},"report":{"anyOf":[{"$ref":"#/components/schemas/PublicMissionReport"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["missionId","report"],"title":"PublicMissionReportResponse"},"PublicOAuthAuthorizationServerMetadata":{"properties":{"issuer":{"type":"string","title":"Issuer"},"authorization_endpoint":{"type":"string","title":"Authorization Endpoint"},"token_endpoint":{"type":"string","title":"Token Endpoint"},"registration_endpoint":{"type":"string","title":"Registration Endpoint"},"response_types_supported":{"items":{"type":"string"},"type":"array","title":"Response Types Supported"},"grant_types_supported":{"items":{"type":"string"},"type":"array","title":"Grant Types Supported"},"token_endpoint_auth_methods_supported":{"items":{"type":"string"},"type":"array","title":"Token Endpoint Auth Methods Supported"},"code_challenge_methods_supported":{"items":{"type":"string"},"type":"array","title":"Code Challenge Methods Supported"},"scopes_supported":{"items":{"type":"string"},"type":"array","title":"Scopes Supported"}},"additionalProperties":false,"type":"object","required":["issuer","authorization_endpoint","token_endpoint","registration_endpoint","response_types_supported","grant_types_supported","token_endpoint_auth_methods_supported","code_challenge_methods_supported","scopes_supported"],"title":"PublicOAuthAuthorizationServerMetadata","example":{"authorization_endpoint":"https://api.nowistay.com/public/oauth/authorize","code_challenge_methods_supported":["S256"],"grant_types_supported":["authorization_code","refresh_token"],"issuer":"https://api.nowistay.com","registration_endpoint":"https://api.nowistay.com/public/oauth/register","response_types_supported":["code"],"scopes_supported":["properties.read","calendar.read","calendar.write","bookings.read","bookings.sensitive.read","bookings.write","booking_parameters.read","booking_parameters.write","missions.read","missions.write","activity.read","team_members.read","webhooks.read","webhooks.write"],"token_endpoint":"https://api.nowistay.com/public/oauth/token","token_endpoint_auth_methods_supported":["none","client_secret_post","client_secret_basic"]}},"PublicOAuthProtectedResourceMetadata":{"properties":{"resource":{"type":"string","title":"Resource"},"authorization_servers":{"items":{"type":"string"},"type":"array","title":"Authorization Servers"},"bearer_methods_supported":{"items":{"type":"string"},"type":"array","title":"Bearer Methods Supported"},"scopes_supported":{"items":{"type":"string"},"type":"array","title":"Scopes Supported"}},"additionalProperties":false,"type":"object","required":["resource","authorization_servers","bearer_methods_supported","scopes_supported"],"title":"PublicOAuthProtectedResourceMetadata","example":{"authorization_servers":["https://api.nowistay.com"],"bearer_methods_supported":["header"],"resource":"https://api.nowistay.com/public/v1","scopes_supported":["properties.read","calendar.read","bookings.read","booking_parameters.read","missions.read","webhooks.read"]}},"PublicPagination":{"properties":{"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"},"totalItems":{"type":"integer","title":"Totalitems"},"totalPages":{"type":"integer","title":"Totalpages"}},"additionalProperties":false,"type":"object","required":["page","limit","totalItems","totalPages"],"title":"PublicPagination","example":{"limit":50,"page":1,"totalItems":1,"totalPages":1}},"PublicProperty":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"propertyType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Propertytype"},"capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capacity"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverurl"},"checkInTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkintime"},"checkOutTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkouttime"},"address":{"anyOf":[{"$ref":"#/components/schemas/PublicAddress"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","name"],"title":"PublicProperty","example":{"address":{"city":"Paris","country":"France","countryCode":"FR","latitude":48.8566,"line1":"12 Rue des Lilas","line2":"Apartment 3B","longitude":2.3522,"postalCode":"75011","timezone":"Europe/Paris"},"capacity":4,"checkInTime":"16:00:00","checkOutTime":"11:00:00","coverUrl":"https://cdn.nowistay.com/properties/101/cover.jpg","createdAt":"2026-01-12T09:20:00Z","id":101,"name":"Lilas Apartment","propertyType":"apartment","updatedAt":"2026-05-21T14:35:00Z"}},"PublicPropertyDetail":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"propertyType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Propertytype"},"capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capacity"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverurl"},"checkInTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkintime"},"checkOutTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkouttime"},"address":{"anyOf":[{"$ref":"#/components/schemas/PublicAddress"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedat"},"rentalLinks":{"items":{"type":"string"},"type":"array","title":"Rentallinks","default":[]},"cutOffTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Cutofftime"},"cutOffDays":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cutoffdays"},"defaultNightRatePrice":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Defaultnightrateprice"},"defaultNightRateCurrency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Defaultnightratecurrency"},"defaultCleaningRate":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Defaultcleaningrate"},"shortStayCleaningRate":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Shortstaycleaningrate"},"guestsIncluded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Guestsincluded"},"extraGuestFee":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Extraguestfee"},"extraGuestFeeChildrenExempt":{"type":"boolean","title":"Extraguestfeechildrenexempt","default":false},"earlyCheckinEarliestTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Earlycheckinearliesttime"},"earlyCheckinExcludedWeekdays":{"items":{"type":"integer"},"type":"array","title":"Earlycheckinexcludedweekdays","default":[]},"lateCheckoutLatestTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Latecheckoutlatesttime"},"lateCheckoutExcludedWeekdays":{"items":{"type":"integer"},"type":"array","title":"Latecheckoutexcludedweekdays","default":[]},"defaultMinStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Defaultminstay"},"defaultMaxStay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Defaultmaxstay"}},"additionalProperties":false,"type":"object","required":["id","name"],"title":"PublicPropertyDetail","example":{"address":{"city":"Paris","country":"France","countryCode":"FR","latitude":48.8566,"line1":"12 Rue des Lilas","line2":"Apartment 3B","longitude":2.3522,"postalCode":"75011","timezone":"Europe/Paris"},"capacity":4,"checkInTime":"16:00:00","checkOutTime":"11:00:00","coverUrl":"https://cdn.nowistay.com/properties/101/cover.jpg","createdAt":"2026-01-12T09:20:00Z","id":101,"name":"Lilas Apartment","propertyType":"apartment","updatedAt":"2026-05-21T14:35:00Z"}},"PublicPropertyListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicProperty"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicPropertyListResponse","example":{"data":[{"address":{"city":"Paris","country":"France","countryCode":"FR","latitude":48.8566,"line1":"12 Rue des Lilas","line2":"Apartment 3B","longitude":2.3522,"postalCode":"75011","timezone":"Europe/Paris"},"capacity":4,"checkInTime":"16:00:00","checkOutTime":"11:00:00","coverUrl":"https://cdn.nowistay.com/properties/101/cover.jpg","createdAt":"2026-01-12T09:20:00Z","id":101,"name":"Lilas Apartment","propertyType":"apartment","updatedAt":"2026-05-21T14:35:00Z"}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicPropertyPatch":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"capacity":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Capacity"},"rentalLinks":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Rentallinks"},"cover":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover"},"checkinTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkintime"},"checkoutTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkouttime"},"cutOffTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Cutofftime"},"cutOffDays":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Cutoffdays"},"propertyType":{"anyOf":[{"type":"string","enum":["apart_hotel","apartment","boat","camping","capsule_hotel","chalet","city_house","country_house","farm_stay","guest_house","holiday_home","holiday_park","homestay","hostel","hotel","inn","lodge","motel","resort","riad","ryokan","tent","villa"]},{"type":"null"}],"title":"Propertytype"},"defaultNightRatePrice":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Defaultnightrateprice"},"defaultNightRateCurrency":{"anyOf":[{"type":"string","maxLength":3,"minLength":3},{"type":"null"}],"title":"Defaultnightratecurrency"},"defaultCleaningRate":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Defaultcleaningrate"},"shortStayCleaningRate":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Shortstaycleaningrate"},"guestsIncluded":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Guestsincluded"},"extraGuestFee":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Extraguestfee"},"extraGuestFeeChildrenExempt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Extraguestfeechildrenexempt"},"earlyCheckinEarliestTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Earlycheckinearliesttime"},"earlyCheckinExcludedWeekdays":{"anyOf":[{"items":{"type":"integer","maximum":6.0,"minimum":0.0},"type":"array"},{"type":"null"}],"title":"Earlycheckinexcludedweekdays"},"lateCheckoutLatestTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Latecheckoutlatesttime"},"lateCheckoutExcludedWeekdays":{"anyOf":[{"items":{"type":"integer","maximum":6.0,"minimum":0.0},"type":"array"},{"type":"null"}],"title":"Latecheckoutexcludedweekdays"},"defaultMinStay":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Defaultminstay"},"defaultMaxStay":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Defaultmaxstay"},"address":{"anyOf":[{"$ref":"#/components/schemas/AddressUpdate"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"PublicPropertyPatch"},"PublicTableResult":{"properties":{"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"rows":{"items":{"items":{},"type":"array"},"type":"array","title":"Rows"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["columns","rows","pagination"],"title":"PublicTableResult"},"PublicTeamMember":{"properties":{"id":{"type":"integer","title":"Id"},"firstName":{"type":"string","title":"Firstname"},"lastName":{"type":"string","title":"Lastname"},"email":{"type":"string","title":"Email"},"mobilePhone":{"type":"string","title":"Mobilephone"},"roles":{"items":{"$ref":"#/components/schemas/TeamRole"},"type":"array","title":"Roles"},"emailEnabled":{"type":"boolean","title":"Emailenabled","description":"Legacy stored value; does not control delivery."},"whatsappEnabled":{"type":"boolean","title":"Whatsappenabled","description":"Legacy stored value; scheduled WhatsApp delivery is controlled by the template."},"isActive":{"type":"boolean","title":"Isactive"},"propertyIds":{"items":{"type":"integer"},"type":"array","title":"Propertyids"},"weeklyOffDays":{"items":{"type":"integer"},"type":"array","title":"Weeklyoffdays"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","firstName","lastName","email","mobilePhone","roles","emailEnabled","whatsappEnabled","isActive","propertyIds","weeklyOffDays","createdAt","updatedAt"],"title":"PublicTeamMember","example":{"createdAt":"2026-01-18T08:00:00Z","email":"nora.bernard@example.com","emailEnabled":true,"firstName":"Nora","id":301,"isActive":true,"lastName":"Bernard","mobilePhone":"+33698765432","propertyIds":[101,102],"roles":["cleaning","checkin"],"updatedAt":"2026-05-25T17:30:00Z","weeklyOffDays":[6],"whatsappEnabled":true}},"PublicTeamMemberListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicTeamMember"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicTeamMemberListResponse","example":{"data":[{"createdAt":"2026-01-18T08:00:00Z","email":"nora.bernard@example.com","emailEnabled":true,"firstName":"Nora","id":301,"isActive":true,"lastName":"Bernard","mobilePhone":"+33698765432","propertyIds":[101,102],"roles":["cleaning","checkin"],"updatedAt":"2026-05-25T17:30:00Z","weeklyOffDays":[6],"whatsappEnabled":true}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"Bearer"},"expires_in":{"type":"integer","title":"Expires In"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token"},"scope":{"type":"string","title":"Scope"},"resource":{"type":"string","title":"Resource"}},"additionalProperties":false,"type":"object","required":["access_token","expires_in","scope","resource"],"title":"PublicTokenResponse","example":{"access_token":"nis_access_token_example","expires_in":3600,"refresh_token":"nis_refresh_token_example","resource":"https://api.nowistay.com/public/v1","scope":"properties.read calendar.read calendar.write bookings.read booking_parameters.read webhooks.read webhooks.write","token_type":"Bearer"}},"PublicUpsellItem":{"properties":{"id":{"type":"integer","title":"Id"},"key":{"type":"string","title":"Key"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl"},"kind":{"type":"string","title":"Kind"},"price":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Price"},"currency":{"type":"string","title":"Currency"},"requiresApproval":{"type":"boolean","title":"Requiresapproval"},"checkinTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkintime"},"checkoutTime":{"anyOf":[{"type":"string","format":"time"},{"type":"null"}],"title":"Checkouttime"},"purchaseDeadlineHours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Purchasedeadlinehours"},"purchaseDeadlineAnchor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purchasedeadlineanchor"},"approverTeamMemberId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approverteammemberid"},"appliesToAllProperties":{"type":"boolean","title":"Appliestoallproperties"},"isActive":{"type":"boolean","title":"Isactive"},"order":{"type":"integer","title":"Order"},"sourceLocale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourcelocale"},"translations":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Translations"},"propertyIds":{"items":{"type":"integer"},"type":"array","title":"Propertyids","default":[]},"offerAtBooking":{"type":"boolean","title":"Offeratbooking","default":false},"minQuantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minquantity"},"maxQuantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxquantity"},"minNights":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minnights"}},"additionalProperties":false,"type":"object","required":["id","key","name","kind","price","currency","requiresApproval","appliesToAllProperties","isActive","order"],"title":"PublicUpsellItem"},"PublicUpsellPurchase":{"properties":{"id":{"type":"integer","title":"Id"},"itemName":{"type":"string","title":"Itemname"},"kind":{"type":"string","title":"Kind"},"quantity":{"type":"integer","title":"Quantity"},"unitAmount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unitamount"},"totalAmount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Totalamount"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"paidAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paidat"}},"additionalProperties":false,"type":"object","required":["id","itemName","kind","quantity","unitAmount","totalAmount","currency","status","paidAt"],"title":"PublicUpsellPurchase"},"PublicWebhook":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","propertyId","url","events","status","createdAt","updatedAt"],"title":"PublicWebhook","example":{"createdAt":"2026-05-27T16:40:00Z","description":"PMS sync","events":["booking.created","booking.updated"],"id":801,"propertyId":101,"status":"active","updatedAt":"2026-05-27T16:40:00Z","url":"https://partner.example.com/nowistay/webhooks"}},"PublicWebhookCreate":{"properties":{"propertyId":{"type":"integer","title":"Propertyid"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"additionalProperties":false,"type":"object","required":["propertyId","url","events"],"title":"PublicWebhookCreate","example":{"description":"PMS sync","events":["booking.created","booking.updated"],"propertyId":101,"url":"https://partner.example.com/nowistay/webhooks"}},"PublicWebhookCreateResponse":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"createdAt":{"type":"string","format":"date-time","title":"Createdat"},"updatedAt":{"type":"string","format":"date-time","title":"Updatedat"},"signingSecret":{"type":"string","title":"Signingsecret"}},"additionalProperties":false,"type":"object","required":["id","propertyId","url","events","status","createdAt","updatedAt","signingSecret"],"title":"PublicWebhookCreateResponse","example":{"createdAt":"2026-05-27T16:40:00Z","description":"PMS sync","events":["booking.created","booking.updated"],"id":801,"propertyId":101,"signingSecret":"whsec_9npwH6J8QyZp1L8U3xqG7sN2","status":"active","updatedAt":"2026-05-27T16:40:00Z","url":"https://partner.example.com/nowistay/webhooks"}},"PublicWebhookListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicWebhook"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PublicPagination"}},"additionalProperties":false,"type":"object","required":["data","pagination"],"title":"PublicWebhookListResponse","example":{"data":[{"createdAt":"2026-05-27T16:40:00Z","description":"PMS sync","events":["booking.created","booking.updated"],"id":801,"propertyId":101,"status":"active","updatedAt":"2026-05-27T16:40:00Z","url":"https://partner.example.com/nowistay/webhooks"}],"pagination":{"limit":50,"page":1,"totalItems":1,"totalPages":1}}},"PublicWebhookPatch":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"events":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string","enum":["active","paused"]},{"type":"null"}],"title":"Status"}},"additionalProperties":false,"type":"object","title":"PublicWebhookPatch","example":{"description":"PMS sync","events":["booking.created","booking.updated"],"status":"active","url":"https://partner.example.com/nowistay/webhooks"}},"PublicWelcomeGuide":{"properties":{"id":{"type":"integer","title":"Id"},"propertyId":{"type":"integer","title":"Propertyid"},"primaryLocale":{"type":"string","title":"Primarylocale"},"activeLocales":{"items":{"type":"string"},"type":"array","title":"Activelocales"},"intro":{"type":"string","title":"Intro","default":""},"intros":{"additionalProperties":{"type":"string"},"type":"object","title":"Intros","default":{}}},"type":"object","required":["id","propertyId","primaryLocale","activeLocales"],"title":"PublicWelcomeGuide"},"RefundMode":{"type":"string","enum":["none","partial","full"],"title":"RefundMode","description":"What to do with a paid direct booking's money when the booking is cancelled."},"TeamRole":{"type":"string","enum":["cleaning","maintenance","manager","urgency","checkin","owner"],"title":"TeamRole"}},"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://api.nowistay.com/public/oauth/authorize","tokenUrl":"https://api.nowistay.com/public/oauth/token","scopes":{"properties.read":"Read property details and operating settings.","properties.write":"Update property details and operating settings.","calendar.read":"Read property availability, nightly rates, and stay restrictions.","calendar.write":"Update property availability, nightly rates, and stay restrictions.","bookings.read":"Read bookings and their financial details.","bookings.sensitive.read":"Include guest contact details, addresses, and access codes in booking responses.","bookings.write":"Create and update direct bookings. Payment requests and refunds also require payments.write.","booking_parameters.read":"Read booking parameter definitions and values.","booking_parameters.write":"Create and update booking parameter definitions and values.","missions.read":"Read missions and completion reports.","missions.write":"Create, update, and assign missions.","activity.read":"Read property activity logs.","team_members.read":"Read team members, contact details, and property assignments.","webhooks.read":"Read webhook subscriptions.","webhooks.write":"Create, update, and delete webhook subscriptions.","customers.read":"Read guest records, contact details, and stay history.","customers.write":"Create guest records.","upsells.read":"Read property upsells and booking purchases.","payments.write":"Request payment when creating a booking and issue cancellation refunds. Also requires bookings.write.","messages.read":"Read guest conversations and their messages.","messages.write":"Send messages to guests.","guides.read":"Read welcome guides and their page content.","guides.write":"Update welcome guides, create and edit pages, reorder pages, and upload guide images.","knowledge.read":"Read private property knowledge questions and answers.","knowledge.write":"Create and update private property knowledge. Copying from another property also requires knowledge.read."}}}}}}}