upsell.delete_offer
writesconfirm
Hard-delete an upsell offer. ON DELETE CASCADE on upsell_bookings.offer_id removes any pending booking trails. Destructive — requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
upsell.list_bookings
read-only
List upsell booking trail for a stay (offered, offered_no_send, accepted, declined, charged, expired). When stayId is omitted, returns the latest 50 across the tenant.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | no | |
limit | integer | no | Default: 50 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
bookings | array of object | yes | |
bookings.id | string | yes | |
bookings.stayId | string | yes | |
bookings.offerId | string | yes | |
bookings.status | string | yes | |
bookings.offeredAt | string | yes | |
bookings.respondedAt | string · nullable | yes |
upsell.list_offers
read-only
List configured upsell offers for this tenant (active + inactive). Used by the operator to inspect what would be offered to guests 2h before check-in.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
activeOnly | boolean | no | Default: false |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
offers | array of object | yes | |
offers.id | string | yes | |
offers.type | string | yes | |
offers.label | string | yes | |
offers.priceCents | integer | yes | |
offers.currency | string | yes | |
offers.active | boolean | yes | |
offers.sortOrder | integer | yes |
upsell.setBookingStatus
writes
Upsell: set booking status. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
bookingId | string | yes | |
status | enum | yes | One of: offered, offered_no_send, accepted, declined, charged, expired |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
upsell.upsert_offer
writes
Create or update an upsell offer. Pass id to update an existing row; omit it to create a new one. Price is in cents (integer).
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | no | |
type | enum | yes | One of: late_checkout, early_checkin, late_checkin, upgrade, extra_bed, other |
label | string | yes | |
priceCents | integer | yes | |
currency | string | no | Default: "EUR" |
active | boolean | no | Default: true |
sortOrder | integer | no | Default: 0 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |