DiningMutation
Fields
acceptOrderOrder!RequiredorderIdInt!RequiredaddProductToVendorMenuBoolean!RequiredmenuIdInt!RequiredproductIdInt!RequiredcancelOrderOrder!RequiredorderIdInt!RequiredcreateBotBot!RequiredinputCreateBotInput!RequiredavatarUrlStringbotTypeBotType!RequiredcategoryStringconfigurationJSONdescriptionStringdisplayNameString!RequiredisPublicBooleanusernameString!RequiredwebhookSecretStringwebhookUrlStringcreateLocationLocation!RequiredinputCreateLocationInput!RequiredaddressString!RequiredcityStringcountryStringdeliveryAvailableBooleandeliveryRadiusFloatemailStringisActiveBooleanlatitudeFloatlongitudeFloatnameString!RequiredphoneStringpickupAvailableBooleanpostalCodeStringstateStringcreateManualReservationReservation!RequiredinputCreateManualReservationInput!RequiredautoConfirmBooleancustomerEmailStringcustomerPhoneStringoccasionStringpartySizeInt!RequiredreservedAtDateTime!RequiredrestaurantTableIdIntseatingPreferenceStringspecialRequestsStringuserIdIntvendorLocationIdInt!RequiredcreateProductProduct!RequiredinputCreateProductInput!RequiredageRestrictedBooleanavailableQtyIntbarcodeStringcapacityStringdeliverableBooleandescriptionStringdigitalBooleandiscountPriceDecimalfeaturedBooleanimageUrls[String!]!RequiredDefaults:isActiveBooleanlocationIdInt!RequirednameString!RequiredpackageCountStringplusOptionBooleanpriceDecimal!RequiredskuStringunitStringcreateServicePeriodRestaurantServicePeriod!RequiredinputCreateRestaurantServicePeriodInput!RequireddefaultTurnTimeMinutesInt!RequiredendTimeNaiveTime!RequiredisActiveBooleanmaxCoversPerSlotInt!RequirednameString!RequiredslotIntervalMinutesInt!RequiredstartTimeNaiveTime!RequiredturnoverBufferMinutesInt!RequiredvendorLocationIdInt!RequiredweekdayInt!RequiredcreateTableRestaurantTable!RequiredinputCreateRestaurantTableInput!RequiredisActiveBooleanisCombinableBooleanlabelString!RequiredmaxCapacityInt!RequiredminCapacityInt!RequiredsectionRestaurantTableSection!RequiredsortOrderIntvendorLocationIdInt!RequiredcreateVendorCouponCoupon!RequiredinputCreateVendorCouponInput!RequiredcodeString!RequiredcolorString!RequireddescriptionStringdiscountDecimal!RequiredexpiresOnDateTimeforDeliveryBoolean!RequiredisActiveBoolean!RequiredmaxCouponAmountDecimalminOrderAmountDecimalpercentageBoolean!RequiredproductIds[Int!]RequiredtimesIntvendorLocationIds[Int!]RequiredcreateVendorMenuAdminMenu!RequiredinputCreateVendorMenuInput!RequiredinOrderIntisActiveBooleannameLocalizedStringInput!RequiredvendorLocationIdInt!RequiredcreateWebhookWebhook!RequiredinputCreateWebhookInput!Requiredevents[WebhookEvent!]!RequiredisActiveBooleanurlString!RequireddecideReservationReservation!RequiredactionReservationApprovalAction!RequiredreservationIdInt!RequireddeleteBotBoolean!RequiredbotIdInt!RequireddeleteLocationBoolean!RequiredlocationIdInt!RequireddeleteProductBoolean!RequiredproductIdInt!RequireddeleteServicePeriodBoolean!RequiredperiodIdInt!RequireddeleteTableBoolean!RequiredtableIdInt!RequireddeleteTurnTimeBoolean!RequiredturnTimeIdInt!RequireddeleteVendorCouponBoolean!RequiredcouponIdInt!RequireddeleteVendorMenuBoolean!RequiredmenuIdInt!RequireddeleteWebhookBoolean!RequiredwebhookIdInt!RequiredmarkOrderPreparingOrder!RequiredorderIdInt!RequiredmarkOrderReadyOrder!RequiredorderIdInt!RequiredregenerateBotSecretString!RequiredbotIdInt!RequiredregenerateWebhookSecretString!RequiredwebhookIdInt!RequiredremoveProductFromVendorMenuBoolean!RequiredmenuIdInt!RequiredproductIdInt!RequiredtestBotWebhookBotWebhookTest!RequiredbotIdInt!RequiredtransitionReservationReservation!RequiredactionReservationTransitionAction!RequiredreservationIdInt!RequiredupdateBotBot!RequiredbotIdInt!RequiredinputUpdateBotInput!RequiredavatarUrlStringcategoryStringconfigurationJSONdescriptionStringdisplayNameStringisPublicBooleanwebhookSecretStringwebhookUrlStringupdateLocationLocation!RequiredinputUpdateLocationInput!RequiredaddressStringcityStringcountryStringdeliveryAvailableBooleandeliveryRadiusFloatemailStringisActiveBooleanlatitudeFloatlongitudeFloatnameStringphoneStringpickupAvailableBooleanpostalCodeStringstateStringlocationIdInt!RequiredupdateProductProduct!RequiredinputUpdateProductInput!RequiredageRestrictedBooleanavailableQtyIntbarcodeStringcapacityStringdeliverableBooleandescriptionStringdigitalBooleandiscountPriceDecimalfeaturedBooleanisActiveBooleannameStringpackageCountStringplusOptionBooleanpriceDecimalskuStringunitStringproductIdInt!RequiredupdateServicePeriodRestaurantServicePeriod!RequiredinputUpdateRestaurantServicePeriodInput!RequireddefaultTurnTimeMinutesIntendTimeNaiveTimeisActiveBooleanmaxCoversPerSlotIntnameStringslotIntervalMinutesIntstartTimeNaiveTimeturnoverBufferMinutesIntweekdayIntperiodIdInt!RequiredupdateTableRestaurantTable!RequiredinputUpdateRestaurantTableInput!RequiredisActiveBooleanisCombinableBooleanlabelStringmaxCapacityIntminCapacityIntsectionRestaurantTableSectionsortOrderInttableIdInt!RequiredupdateVendorCouponCoupon!RequiredcouponIdInt!RequiredinputUpdateVendorCouponInput!RequiredcodeStringcolorStringdescriptionStringdiscountDecimalexpiresOnDateTimeforDeliveryBooleanisActiveBooleanmaxCouponAmountDecimalminOrderAmountDecimalpercentageBooleanproductIds[Int!]RequiredtimesIntvendorLocationIds[Int!]RequiredupdateVendorMenuAdminMenu!RequiredinputUpdateVendorMenuInput!RequiredinOrderIntisActiveBooleanmenuIdInt!RequiredupdateWebhookWebhook!RequiredinputUpdateWebhookInput!Requiredevents[WebhookEvent!]RequiredisActiveBooleanurlStringwebhookIdInt!RequiredupsertTurnTimeRestaurantTurnTime!RequiredinputUpsertRestaurantTurnTimeInput!RequiredmaxPartySizeInt!RequiredminPartySizeInt!RequiredrestaurantServicePeriodIdInt!RequiredturnTimeMinutesInt!RequiredvendorLocationIdInt!Required
Accept a pending order.
Order to accept.
Put a product on a menu. Idempotent — a product already on the menu is
left where it is.
Menu to add the product to.
Product to add.
Cancel a pending or accepted order.
Order to cancel.
Create a new bot owned by the authenticated vendor.
Requires a user-context token, unlike the other bot mutations: The bot records a human author, which is required and must be a real user. A client_credentials token has no honest value to put there, and inventing one would corrupt the attribution the public bot directory renders.
Details of the bot to create.
URL of the bot's avatar image.
Which runtime surface the bot plugs into.
Directory category the bot is filed under.
Free-form JSON configuration passed through to the bot runtime.
What the bot does, shown in the directory. Up to 500 characters.
Human-readable name shown in chat and the directory. 2–100 characters.
Whether to list the bot in the public directory. Defaults to false.
Handle the bot is mentioned by, without the leading @. 3–50 characters, alphanumeric and underscores only, and unique platform-wide.
Shared secret the delivery signature is computed with. 32–128
characters. Store it — it is never returned again.
HTTPS URL to deliver the bot's events to. Without one it receives nothing.
Create a new location for the authenticated vendor.
Details of the location to create.
Street address of the branch.
City the branch is in.
Country the branch is in.
Whether the branch delivers. Defaults to true.
How far the branch delivers, in kilometres. Omit for unlimited.
Contact email address for the branch.
Whether the branch is in service. Defaults to true.
Latitude in decimal degrees (WGS 84).
Longitude in decimal degrees (WGS 84).
Branch name, e.g. Downtown store.
Contact phone number for the branch.
Whether customers can collect from this branch. Defaults to true.
Postal or ZIP code.
State, province or region the branch is in.
Create a manual (phone/walk-in) reservation.
Details of the reservation to record.
Whether to auto-confirm the reservation on creation (host-entered
reservations are usually already confirmed).
Guest's email address, up to 255 characters.
Guest's phone number, up to 32 characters.
What the party is celebrating. Optional, up to 100 characters.
Number of guests (1-200).
When the party is expected (UTC).
Table to assign. Omit to let the restaurant assign one later.
Where the guest would like to sit. Optional, up to 100 characters.
Free-text requests for the restaurant. Optional, up to 2000 characters.
The guest, identified exactly one way — userId, customerPhone or customerEmail. Supplying more than one is rejected, as is supplying none: a reservation always has a guest.
Branch to book a table at.
Create a product. Currency is taken from the vendor configuration.
Details of the product to create.
Whether buyers must pass an age check. Defaults to false.
Opening stock for locationId. Omit to leave the branch unstocked.
Scanned barcode (EAN/UPC) if the product carries one.
Packaged size as free text, e.g. 500 alongside a unit of ml.
Whether the product can be delivered. Defaults to true.
Long-form description shown on the product page.
Whether the product is digital and needs no physical fulfilment. Defaults to false.
Sale price in major units. Defaults to 0, meaning no discount.
Whether to surface the product in featured placements. Defaults to false.
Publicly reachable image URLs. At least one is required — a product with
no image renders as a blank tile everywhere it is listed. Defaulted at
the schema level so the omission is rejected by the service with an
actionable message rather than by GraphQL validation.
Whether the product is orderable. Defaults to true.
Branch the initial inventory row is attached to. Must belong to the
authenticated vendor.
Customer-facing product name.
Number of items in a multi-pack, as free text.
Whether the product is restricted to Plus members. Defaults to false.
List price in major units of the vendor's currency, e.g. 12.50. Excludes tax.
Vendor's own stock-keeping unit. Not checked for uniqueness.
Unit capacity is expressed in, e.g. g, ml, piece.
Create a service period.
Details of the service period to create.
How long a table is held per booking when no party-size rule matches
(15-600).
Local time the shift stops taking bookings.
Whether the shift takes bookings. Defaults to true.
Most guests the kitchen will take in a single slot (1-10000).
Shift name shown to staff, such as "Dinner". 1-100 characters.
Spacing between consecutive bookable start times, in minutes (5-240).
Local time the shift opens for bookings.
Extra minutes left between one booking and the next on the same table
(0-240).
Branch the shift belongs to.
0 = Monday … 6 = Sunday.
Create a table at one of the vendor's locations.
Details of the table to create.
Whether the table is in use. Defaults to true.
Whether the table can be joined to others. Defaults to false.
Name staff use for the table, such as "T12". 1-50 characters.
Largest party the table seats (1-100).
Smallest party the table is offered to (1-100).
Part of the room the table stands in.
Position in the table list; lower values sort first. Defaults to 0.
Location the table belongs to.
Create a coupon on this vendor's storefront.
The code must be unique platform-wide, so a collision with an existing
coupon — including another vendor's — is rejected.
Details of the coupon to create.
Code customers type at checkout. Must be unique across the platform.
Hex colour for UI display (e.g. "#FF5733").
Terms or explanation shown with the coupon. Optional.
Percentage when percentage is true, otherwise a fixed amount.
Never negative: the order paths subtract this, so a negative value would increase what the customer pays.
When the coupon stops working (UTC). Omit for a coupon that never expires.
Whether the discount applies to the delivery fee.
Whether the coupon can be redeemed straight away.
Caps a percentage discount. Ignored for fixed amounts.
Smallest order the coupon applies to, in the vendor's currency. Omit for no minimum.
Whether discount is a percentage rather than a fixed amount.
Restrict to specific products. All of the vendor's products when empty.
Total redemptions allowed across all customers.
Restrict to specific locations. Valid at all of the vendor's locations
when omitted or empty.
Create a menu on the authenticated vendor's storefront.
Details of the menu to create.
Sort position among the vendor's menus, lowest first. Omit to leave it unset.
Whether the menu is visible to customers. Omit for the default.
Menu name shown to customers, in as many languages as you offer.
The location this menu belongs to. Must be one of the vendor's own.
Register a new webhook endpoint for the authenticated business.
Endpoint URL and the events to subscribe to.
Events to subscribe to. At least one.
Whether to start delivering immediately. Defaults to active.
HTTPS URL to deliver events to.
Approve or reject a pending reservation request.
Whether to approve or reject the request.
Reservation request to decide.
Permanently delete a bot. Returns true on success.
Unique identifier of the bot to delete.
Delete a location. Returns true on success.
Unique identifier of the location to delete.
Delete a product (soft delete). Returns true on success.
Unique identifier of the product to delete.
Delete a service period. Returns true on success.
Unique identifier of the service period to delete.
Delete one of the vendor's tables. Returns true on success.
Unique identifier of the table to delete.
Delete a turn time. Returns true on success.
Unique identifier of the turn time to delete.
Delete a coupon this vendor owns.
Unique identifier of the coupon to delete.
Delete one of the vendor's menus.
Unique identifier of the menu to delete.
Permanently delete a webhook. Returns true on success.
Unique identifier of the webhook endpoint to delete.
Mark an accepted order as preparing.
Order now being prepared.
Mark a preparing order as ready.
Order now ready for collection.
Regenerate a webhook bot's secret, invalidating the previous one.
Returns the new secret so the caller can update their webhook handler.
Unique identifier of the bot to issue a new secret for.
Rotate a webhook's signing secret, returning the new secret. The new
value is only surfaced here — it is stored hashed-in-place and cannot be
retrieved again afterwards.
Webhook whose signing secret to replace.
Take a product off a menu. The product itself is untouched.
Menu to remove the product from.
Product to remove.
Queue a test webhook delivery for a webhook-type bot.
Bot whose webhook endpoint to test.
Move a reservation through its host-stand lifecycle (seated/completed/…).
Stage to move the reservation to.
Reservation to move.
Update an existing bot. Permissions, version and tags are not editable
through the developer API.
Bot to update.
Fields to change on the bot.
Replacement avatar image URL.
Replacement directory category.
Replacement JSON configuration. Replaces the stored blob outright.
Replacement description. Up to 500 characters.
Replacement display name. 2–100 characters.
Whether the bot is listed in the public directory.
Rotated signing secret. 32–128 characters. Supplying it invalidates the
previous secret immediately.
Replacement HTTPS delivery URL.
Update an existing location.
Fields to change on the location.
Replacement street address.
Replacement city.
Replacement country.
Whether the branch delivers.
Replacement delivery radius in kilometres.
Replacement contact email address.
Whether the branch is in service.
Replacement latitude in decimal degrees (WGS 84).
Replacement longitude in decimal degrees (WGS 84).
Replacement branch name.
Replacement contact phone number.
Whether customers can collect from this branch.
Replacement postal or ZIP code.
Replacement state, province or region.
Location to update.
Update a product.
Fields to change on the product.
Whether buyers must pass an age check.
New stock level, applied to every branch stocking this product.
Replacement barcode.
Replacement packaged size.
Whether the product can be delivered.
Replacement description.
Whether the product is digital.
Replacement sale price in major units. 0 clears the discount.
Whether the product appears in featured placements.
Whether the product is orderable.
Replacement product name.
Replacement multi-pack count.
Whether the product is restricted to Plus members.
Replacement list price in major units of the product's currency.
Replacement stock-keeping unit.
Replacement unit for capacity.
Product to update.
Update a service period.
Fields to change on the service period.
How long a table is held per booking when no party-size rule matches
(15-600).
New local time the shift stops taking bookings.
Whether the shift takes bookings.
Most guests the kitchen will take in a single slot (1-10000).
New shift name. Omit to leave unchanged.
Spacing between consecutive bookable start times, in minutes (5-240).
New local time the shift opens for bookings.
Extra minutes left between one booking and the next on the same table
(0-240).
0 = Monday … 6 = Sunday.
Service period to update.
Update one of the vendor's tables.
Fields to change on the table.
Whether the table is in use.
Whether the table can be joined to others.
New name staff use for the table. Omit to leave unchanged.
New largest party the table seats (1-100).
New smallest party the table is offered to (1-100).
New part of the room the table stands in.
New position in the table list; lower values sort first.
Table to update.
Update a coupon this vendor owns.
Coupon to update.
Fields to change on the coupon.
New code customers type at checkout. Omit to leave it unchanged.
New hex colour for display (e.g. #FF5733). Omit to leave it unchanged.
New terms or explanation. Omit to leave it unchanged.
Never negative, for the same reason as on create: the order paths
subtract it.
New expiry (UTC). Omit to leave it unchanged.
Whether the discount applies to the delivery fee. Omit to leave it unchanged.
Whether the coupon can still be redeemed. Omit to leave it unchanged.
New cap on a percentage discount. Omit to leave it unchanged.
New order minimum, in the vendor's currency. Omit to leave it unchanged.
Whether discount is a percentage. Omit to leave it unchanged.
Replaces the product restriction outright. An empty list clears it.
New total redemption limit. Omit to leave it unchanged.
Replaces the location restriction outright. Some(vec![]) clears it.
Rename a menu, change its description, or activate/deactivate it.
Fields to change on the menu.
Sort position among the vendor's menus, lowest first. Omit to leave unchanged.
Whether the menu is visible to customers. Omit to leave unchanged.
Menu name shown to customers. Omit to leave every language unchanged.
Menu to update.
Modify an existing webhook's URL, events, or active status.
Fields to change on the webhook.
Replacement subscription list. Replaces the existing set outright.
Whether the webhook delivers. Set false to pause without deleting.
Replacement HTTPS delivery URL.
Webhook to update.
Create or update a turn time.
Turn time to set, replacing any existing one.
Largest party the rule covers (1-200).
Smallest party the rule covers (1-200).
Shift the rule applies during.
How long a table is held for parties in this band (15-600).
Branch the rule applies at.
Built with