ShopMutation
Fields
acceptOrderOrder!RequiredorderIdInt!RequiredaddProductToVendorMenuBoolean!RequiredmenuIdInt!RequiredproductIdInt!RequiredcancelOrderOrder!RequiredorderIdInt!RequiredcreateBotBot!RequiredinputCreateBotInput!RequiredavatarUrlStringbotTypeBotType!RequiredcategoryStringconfigurationJSONdescriptionStringdisplayNameString!RequiredisPublicBooleanusernameString!RequiredwebhookSecretStringwebhookUrlStringcreateLocationLocation!RequiredinputCreateLocationInput!RequiredaddressString!RequiredcityStringcountryStringdeliveryAvailableBooleandeliveryRadiusFloatemailStringisActiveBooleanlatitudeFloatlongitudeFloatnameString!RequiredphoneStringpickupAvailableBooleanpostalCodeStringstateStringcreateProductProduct!RequiredinputCreateProductInput!RequiredageRestrictedBooleanavailableQtyIntbarcodeStringcapacityStringdeliverableBooleandescriptionStringdigitalBooleandiscountPriceDecimalfeaturedBooleanimageUrls[String!]!RequiredDefaults:isActiveBooleanlocationIdInt!RequirednameString!RequiredpackageCountStringplusOptionBooleanpriceDecimal!RequiredskuStringunitStringcreateVendorCouponCoupon!RequiredinputCreateVendorCouponInput!RequiredcodeString!RequiredcolorString!RequireddescriptionStringdiscountDecimal!RequiredexpiresOnDateTimeforDeliveryBoolean!RequiredisActiveBoolean!RequiredmaxCouponAmountDecimalminOrderAmountDecimalpercentageBoolean!RequiredproductIds[Int!]RequiredtimesIntvendorLocationIds[Int!]RequiredcreateVendorMenuAdminMenu!RequiredinputCreateVendorMenuInput!RequiredinOrderIntisActiveBooleannameLocalizedStringInput!RequiredvendorLocationIdInt!RequiredcreateWebhookWebhook!RequiredinputCreateWebhookInput!Requiredevents[WebhookEvent!]!RequiredisActiveBooleanurlString!RequireddeleteBotBoolean!RequiredbotIdInt!RequireddeleteLocationBoolean!RequiredlocationIdInt!RequireddeleteProductBoolean!RequiredproductIdInt!RequireddeleteVendorCouponBoolean!RequiredcouponIdInt!RequireddeleteVendorMenuBoolean!RequiredmenuIdInt!RequireddeleteWebhookBoolean!RequiredwebhookIdInt!RequiredmarkOrderPreparingOrder!RequiredorderIdInt!RequiredmarkOrderReadyOrder!RequiredorderIdInt!RequiredprovisionUnitCredentialAutonomousUnitCredential!RequiredidInt!RequiredregenerateBotSecretString!RequiredbotIdInt!RequiredregenerateWebhookSecretString!RequiredwebhookIdInt!RequiredregisterUnitAutonomousUnit!RequiredinputRegisterVendorAutonomousUnitInput!RequiredcountryIdIntfirmwareVersionStringhomeBaseLocationIdIntmakeStringmaxRangeKmFloat!RequiredmaxSpeedKphFloat!RequiredmodelStringpayloadCapacityKgFloat!RequiredserialNoString!RequiredunitKindAutonomousUnitKind!RequiredremoveProductFromVendorMenuBoolean!RequiredmenuIdInt!RequiredproductIdInt!RequiredrevokeUnitCredentialBoolean!RequiredidInt!RequiredsetUnitStatusBoolean!RequiredidInt!RequiredstatusAutonomousUnitStatus!RequiredtestBotWebhookBotWebhookTest!RequiredbotIdInt!RequiredupdateBotBot!RequiredbotIdInt!RequiredinputUpdateBotInput!RequiredavatarUrlStringcategoryStringconfigurationJSONdescriptionStringdisplayNameStringisPublicBooleanwebhookSecretStringwebhookUrlStringupdateLocationLocation!RequiredinputUpdateLocationInput!RequiredaddressStringcityStringcountryStringdeliveryAvailableBooleandeliveryRadiusFloatemailStringisActiveBooleanlatitudeFloatlongitudeFloatnameStringphoneStringpickupAvailableBooleanpostalCodeStringstateStringlocationIdInt!RequiredupdateProductProduct!RequiredinputUpdateProductInput!RequiredageRestrictedBooleanavailableQtyIntbarcodeStringcapacityStringdeliverableBooleandescriptionStringdigitalBooleandiscountPriceDecimalfeaturedBooleanisActiveBooleannameStringpackageCountStringplusOptionBooleanpriceDecimalskuStringunitStringproductIdInt!RequiredupdateUnitAutonomousUnit!RequiredidInt!RequiredinputUpdateOwnAutonomousUnitInput!RequiredfirmwareVersionStringhomeBaseLocationIdIntisActiveBooleanmakeStringmaxRangeKmFloatmaxSpeedKphFloatmodelStringpayloadCapacityKgFloatupdateVendorCouponCoupon!RequiredcouponIdInt!RequiredinputUpdateVendorCouponInput!RequiredcodeStringcolorStringdescriptionStringdiscountDecimalexpiresOnDateTimeforDeliveryBooleanisActiveBooleanmaxCouponAmountDecimalminOrderAmountDecimalpercentageBooleanproductIds[Int!]RequiredtimesIntvendorLocationIds[Int!]RequiredupdateVendorMenuAdminMenu!RequiredinputUpdateVendorMenuInput!RequiredinOrderIntisActiveBooleanmenuIdInt!RequiredupdateWebhookWebhook!RequiredinputUpdateWebhookInput!Requiredevents[WebhookEvent!]RequiredisActiveBooleanurlStringwebhookIdInt!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 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 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.
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 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.
Issue machine credentials for a unit.
The plaintext secret is returned exactly once and only its hash is stored, so a lost secret can only be replaced, never recovered. Re-provisioning a credentialed unit is refused rather than silently rotating — that would strand the unit in the field with a secret nobody holds.
Unit to issue a new credential for.
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.
Register a unit against the acting vendor, which owns it.
Details of the unit to register.
Country the unit is registered in. Optional.
Firmware the unit is running, up to 64 characters. Optional.
Depot the unit returns to between jobs. Optional.
Manufacturer name, up to 128 characters. Optional.
One-way range. Dispatch requires this to cover the round trip.
Top speed in kilometres per hour (0.1 to 300).
Model name, up to 128 characters. Optional.
Kilograms the unit can carry. Must be positive — a unit that can
carry nothing can never be dispatched.
Manufacturer serial number, 3-128 characters. Must be unique.
Whether the unit is a drone, a ground robot or a pavement robot.
Take a product off a menu. The product itself is untouched.
Menu to remove the product from.
Product to remove.
Revoke a unit's credentials.
Takes effect immediately: an already-issued token stops working on its
next call rather than surviving until it expires.
Unique identifier of the unit whose credentials to revoke.
Report a unit's operational status.
Restricted to the states an owner legitimately controls. Assigned, Enroute and Returning follow from dispatch decisions and Disabled is an administrative act — accepting either here would let an owner desynchronise a unit from its live job or quietly un-ground it.
Unit to update.
Status to move the unit to.
Queue a test webhook delivery for a webhook-type bot.
Bot whose webhook endpoint to test.
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 unit's mutable attributes.
Verification status is deliberately absent — a partner cannot verify
its own hardware. That stays an admin decision.
Unit to update.
Fields to change on the unit.
Firmware the unit is running, up to 64 characters.
Depot the unit returns to between jobs.
Whether the unit is in service.
Manufacturer name, up to 128 characters.
One-way range in kilometres (0.1 to 500).
Top speed in kilometres per hour (0.1 to 300).
Model name, up to 128 characters.
Weight the unit can carry, in kilograms (0.01 to 500).
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.
Built with