{ "openapi": "3.0.0", "info": { "title": "chowdash_rider_v1 API", "version": "1.1.0", "description": "API documentation for chowdash_rider_v1" }, "paths": { "/dish/{slug}": { "get": { "operationId": "getDishSlug", "tags": [ "dish" ], "summary": "Public: one dish, its price, ingredients and reviews, as shareable HTML with schema.org markup.", "description": "Public: one dish, its price, ingredients and reviews, as shareable HTML with schema.org markup.", "responses": { "200": { "description": "Dish page as HTML.", "content": { "text/html; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/kitchen/{slug}": { "get": { "operationId": "getKitchenSlug", "tags": [ "kitchen" ], "summary": "Public: one kitchen, its menu, hours and trust signals, as shareable HTML with schema.org markup.", "description": "Public: one kitchen, its menu, hours and trust signals, as shareable HTML with schema.org markup.", "responses": { "200": { "description": "Kitchen page as HTML.", "content": { "text/html; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/kitchens": { "get": { "operationId": "getKitchens", "tags": [ "kitchens" ], "summary": "Public: crawlable index of verified kitchens.", "description": "Public: crawlable index of verified kitchens.", "responses": { "200": { "description": "Kitchen index as HTML.", "content": { "text/html; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/llms.txt": { "get": { "operationId": "getLlmsTxt", "tags": [ "llms.txt" ], "summary": "Public: the kitchen catalogue restated for language models.", "description": "Public: the kitchen catalogue restated for language models.", "responses": { "200": { "description": "Catalogue as Markdown.", "content": { "text/plain; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/robots.txt": { "get": { "operationId": "getRobotsTxt", "tags": [ "robots.txt" ], "summary": "Public: crawl policy for search engines, AI agents and link-preview fetchers.", "description": "Public: crawl policy for search engines, AI agents and link-preview fetchers.", "responses": { "200": { "description": "Robots directives as text.", "content": { "text/plain; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/sitemap.xml": { "get": { "operationId": "getSitemapXml", "tags": [ "sitemap.xml" ], "summary": "Public: sitemap generated from live catalogue rows.", "description": "Public: sitemap generated from live catalogue rows.", "responses": { "200": { "description": "Sitemap as XML.", "content": { "application/xml; charset=utf-8": { "schema": { "type": "string" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/admin/marketplace/vendors/{vendor_profile_id}/status": { "patch": { "operationId": "patchAdminMarketplaceVendorsVendorProfileIdStatus", "tags": [ "admin" ], "summary": "Admin review and moderation for a ChooseChow vendor.", "description": "Admin review and moderation for a ChooseChow vendor.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSetVendorStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSetVendorStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/assist/help-tickets": { "post": { "operationId": "postAssistHelpTickets", "tags": [ "assist" ], "summary": "Create a ChooseChow help ticket.", "description": "Create a ChooseChow help ticket.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateHelpTicketRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateHelpTicketResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/assist/help-tickets/{ticket_id}/ai-resolution": { "post": { "operationId": "postAssistHelpTicketsTicketIdAiResolution", "tags": [ "assist" ], "summary": "Record an AI support resolution.", "description": "Record an AI support resolution.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordAIResolutionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordAIResolutionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/assist/help-tickets/{ticket_id}/escalate": { "post": { "operationId": "postAssistHelpTicketsTicketIdEscalate", "tags": [ "assist" ], "summary": "Escalate a help ticket to support.", "description": "Escalate a help ticket to support.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EscalateHelpTicketRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EscalateHelpTicketResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/checkout-sessions": { "post": { "operationId": "postBillingCheckoutSessions", "tags": [ "billing" ], "summary": "Create a ChooseChow checkout session.", "description": "Create a ChooseChow checkout session.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCheckoutSessionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCheckoutSessionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/payments/confirm": { "post": { "operationId": "postBillingPaymentsConfirm", "tags": [ "billing" ], "summary": "Confirm a marketplace payment.", "description": "Confirm a marketplace payment.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPaymentRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPaymentResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/profile-wallet/{profile_id}": { "get": { "operationId": "getBillingProfileWalletProfileId", "tags": [ "billing" ], "summary": "Get a profile-owned wallet balance.", "description": "Get a profile-owned wallet balance.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetProfileWalletBalanceResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/profile-wallet/{profile_id}/cashout": { "post": { "operationId": "postBillingProfileWalletProfileIdCashout", "tags": [ "billing" ], "summary": "Request a profile-owned wallet cashout.", "description": "Request a profile-owned wallet cashout.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestProfileCashoutRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestProfileCashoutResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/refunds": { "post": { "operationId": "postBillingRefunds", "tags": [ "billing" ], "summary": "Request a marketplace refund.", "description": "Request a marketplace refund.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestRefundRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestRefundResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/subscription-plans": { "get": { "operationId": "getBillingSubscriptionPlans", "tags": [ "billing" ], "summary": "List the ChooseChow subscription plan catalog.", "description": "List the ChooseChow subscription plan catalog.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSubscriptionPlansResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/subscriptions": { "post": { "operationId": "postBillingSubscriptions", "tags": [ "billing" ], "summary": "Create a ChooseChow subscription.", "description": "Create a ChooseChow subscription.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSubscriptionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSubscriptionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/subscriptions/{subscription_id}/cancel": { "post": { "operationId": "postBillingSubscriptionsSubscriptionIdCancel", "tags": [ "billing" ], "summary": "Cancel a ChooseChow subscription.", "description": "Cancel a ChooseChow subscription.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSubscriptionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSubscriptionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/billing/webhooks/paystack": { "post": { "operationId": "postBillingWebhooksPaystack", "tags": [ "billing" ], "summary": "Public: Paystack webhook (HMAC-SHA512 signature verified).", "description": "Public: Paystack webhook (HMAC-SHA512 signature verified).", "responses": { "200": { "description": "Webhook recorded and reconciled.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandardSuccessResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/deliveries": { "post": { "operationId": "postDeliveries", "tags": [ "deliveries" ], "summary": "Create a delivery from a ChooseChow or operations order handoff.", "description": "Create a delivery from a ChooseChow or operations order handoff.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDeliveryRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDeliveryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/deliveries/active": { "get": { "operationId": "getDeliveriesActive", "tags": [ "deliveries" ], "summary": "Get the rider active delivery.", "description": "Get the rider active delivery.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetActiveDeliveryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/deliveries/{delivery_id}/transition": { "post": { "operationId": "postDeliveriesDeliveryIdTransition", "tags": [ "deliveries" ], "summary": "Transition a delivery stage.", "description": "Transition a delivery stage.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransitionDeliveryRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransitionDeliveryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/discover/chefs": { "get": { "operationId": "getDiscoverChefs", "tags": [ "discover" ], "summary": "Public: verified chefs/vendors for the discovery/landing surface. Optional ?area= ranks kitchens whose stated location contains it first; it never hides the rest.", "description": "Public: verified chefs/vendors for the discovery/landing surface. Optional ?area= ranks kitchens whose stated location contains it first; it never hides the rest.", "responses": { "200": { "description": "Allowlisted verified chefs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResult" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/discover/dishes": { "get": { "operationId": "getDiscoverDishes", "tags": [ "discover" ], "summary": "Public: popular available dishes for the discovery/landing surface.", "description": "Public: popular available dishes for the discovery/landing surface.", "responses": { "200": { "description": "Allowlisted popular dishes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResult" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/logistics/offers/rank": { "post": { "operationId": "postLogisticsOffersRank", "tags": [ "logistics" ], "summary": "Rank live offer candidates.", "description": "Rank live offer candidates.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RankOfferCandidatesRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RankOfferCandidatesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/logistics/rider-location": { "post": { "operationId": "postLogisticsRiderLocation", "tags": [ "logistics" ], "summary": "Update rider location.", "description": "Update rider location.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateRiderLocationRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateRiderLocationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/maps/routes/delivery/sync": { "post": { "operationId": "postMapsRoutesDeliverySync", "tags": [ "maps" ], "summary": "Sync a delivery route.", "description": "Sync a delivery route.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncDeliveryRouteRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncDeliveryRouteResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/maps/routes/estimate": { "post": { "operationId": "postMapsRoutesEstimate", "tags": [ "maps" ], "summary": "Estimate a route.", "description": "Estimate a route.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EstimateRouteRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EstimateRouteResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/cart/checkout": { "post": { "operationId": "postMarketplaceCartCheckout", "tags": [ "marketplace" ], "summary": "Checkout a ChooseChow cart into an order.", "description": "Checkout a ChooseChow cart into an order.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutCartRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutCartResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/cart/items": { "post": { "operationId": "postMarketplaceCartItems", "tags": [ "marketplace" ], "summary": "Add an item to a ChooseChow cart.", "description": "Add an item to a ChooseChow cart.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddCartItemRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddCartItemResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/cart/promo-quote": { "post": { "operationId": "postMarketplaceCartPromoQuote", "tags": [ "marketplace" ], "summary": "Preview a promotion against the caller's cart.", "description": "Preview a promotion against the caller's cart.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotePromoRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotePromoResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/orders/{order_id}": { "get": { "operationId": "getMarketplaceOrdersOrderId", "tags": [ "marketplace" ], "summary": "Get a ChooseChow order.", "description": "Get a ChooseChow order.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOrderResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/orders/{order_id}/status": { "patch": { "operationId": "patchMarketplaceOrdersOrderIdStatus", "tags": [ "marketplace" ], "summary": "Update a ChooseChow order status.", "description": "Update a ChooseChow order status.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetOrderStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetOrderStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/promos": { "get": { "operationId": "getMarketplacePromos", "tags": [ "marketplace" ], "summary": "List promotion campaigns.", "description": "List promotion campaigns.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPromosResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMarketplacePromos", "tags": [ "marketplace" ], "summary": "Create a percentage promotion.", "description": "Create a percentage promotion.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePromoRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePromoResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/promos/{campaign_id}": { "patch": { "operationId": "patchMarketplacePromosCampaignId", "tags": [ "marketplace" ], "summary": "Pause or resume a campaign.", "description": "Pause or resume a campaign.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetPromoStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetPromoStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/marketplace/reservations": { "post": { "operationId": "postMarketplaceReservations", "tags": [ "marketplace" ], "summary": "Hold a meal on a future date without paying or touching the cart.", "description": "Hold a meal on a future date without paying or touching the cart.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateReservationRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateReservationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/drops/{drop_id}/deliver": { "post": { "operationId": "postMealPlansDropsDropIdDeliver", "tags": [ "meal-plans" ], "summary": "Confirm a drop delivered and release its escrow.", "description": "Confirm a drop delivered and release its escrow.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeliverDropRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeliverDropResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/drops/{drop_id}/fail": { "post": { "operationId": "postMealPlansDropsDropIdFail", "tags": [ "meal-plans" ], "summary": "Record a failed drop and append a replacement.", "description": "Record a failed drop and append a replacement.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailDropRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailDropResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/drops/{drop_id}/skip": { "post": { "operationId": "postMealPlansDropsDropIdSkip", "tags": [ "meal-plans" ], "summary": "Skip one scheduled drop within the allowance.", "description": "Skip one scheduled drop within the allowance.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkipDropRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkipDropResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/quote": { "post": { "operationId": "postMealPlansQuote", "tags": [ "meal-plans" ], "summary": "Price a meal plan at a chosen drop frequency (live saving).", "description": "Price a meal plan at a chosen drop frequency (live saving).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/rates": { "get": { "operationId": "getMealPlansRates", "tags": [ "meal-plans" ], "summary": "Read effective meal-plan rates.", "description": "Read effective meal-plan rates.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMealPlansRates", "tags": [ "meal-plans" ], "summary": "Publish a new meal-plan rate version.", "description": "Publish a new meal-plan rate version.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetRatesRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetRatesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions": { "get": { "operationId": "getMealPlansSubscriptions", "tags": [ "meal-plans" ], "summary": "List a customer's meal-plan subscriptions.", "description": "List a customer's meal-plan subscriptions.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSubscriptionsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMealPlansSubscriptions", "tags": [ "meal-plans" ], "summary": "Subscribe to a chef meal-plan offering.", "description": "Subscribe to a chef meal-plan offering.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscribeRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscribeResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions/{subscription_id}/cancel": { "patch": { "operationId": "patchMealPlansSubscriptionsSubscriptionIdCancel", "tags": [ "meal-plans" ], "summary": "Cancel a subscription and refund the unfulfilled balance.", "description": "Cancel a subscription and refund the unfulfilled balance.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSubscriptionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSubscriptionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions/{subscription_id}/chef-exit": { "post": { "operationId": "postMealPlansSubscriptionsSubscriptionIdChefExit", "tags": [ "meal-plans" ], "summary": "Run the chef-exit substitution chain.", "description": "Run the chef-exit substitution chain.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChefExitRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChefExitResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions/{subscription_id}/drops": { "get": { "operationId": "getMealPlansSubscriptionsSubscriptionIdDrops", "tags": [ "meal-plans" ], "summary": "List a subscription's scheduled drops.", "description": "List a subscription's scheduled drops.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListDropsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions/{subscription_id}/pause": { "patch": { "operationId": "patchMealPlansSubscriptionsSubscriptionIdPause", "tags": [ "meal-plans" ], "summary": "Pause a subscription between cycles.", "description": "Pause a subscription between cycles.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSubscriptionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSubscriptionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/subscriptions/{subscription_id}/resume": { "patch": { "operationId": "patchMealPlansSubscriptionsSubscriptionIdResume", "tags": [ "meal-plans" ], "summary": "Resume a paused subscription.", "description": "Resume a paused subscription.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSubscriptionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSubscriptionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/meal-plans/zones": { "get": { "operationId": "getMealPlansZones", "tags": [ "meal-plans" ], "summary": "List meal-plan delivery zones.", "description": "List meal-plan delivery zones.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListZonesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMealPlansZones", "tags": [ "meal-plans" ], "summary": "Create a meal-plan delivery zone.", "description": "Create a meal-plan delivery zone.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateZoneRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateZoneResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/media/objects/{key...}": { "get": { "operationId": "getMediaObjectsKey", "tags": [ "media" ], "summary": "Stream a stored media object back to the browser.", "description": "Stream a stored media object back to the browser.", "responses": { "200": { "description": "Object bytes streamed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandardSuccessResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/media/uploads": { "post": { "operationId": "postMediaUploads", "tags": [ "media" ], "summary": "Upload a small image (chef avatar, menu cover, dish photo).", "description": "Upload a small image (chef avatar, menu cover, dish photo).", "responses": { "201": { "description": "Image stored; returned url is safe to embed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResult" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/menu/chefs/{chef_profile_id}/dishes": { "get": { "operationId": "getMenuChefsChefProfileIdDishes", "tags": [ "menu" ], "summary": "List a chef's dish library.", "description": "List a chef's dish library.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChefDishesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/dishes": { "post": { "operationId": "postMenuDishes", "tags": [ "menu" ], "summary": "Create a standalone dish in the chef's library.", "description": "Create a standalone dish in the chef's library.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDishRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/dishes/{dish_id}": { "delete": { "operationId": "deleteMenuDishesDishId", "tags": [ "menu" ], "summary": "Permanently delete a dish from the chef's library.", "description": "Permanently delete a dish from the chef's library.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "getMenuDishesDishId", "tags": [ "menu" ], "summary": "Fetch one dish with full detail.", "description": "Fetch one dish with full detail.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "patch": { "operationId": "patchMenuDishesDishId", "tags": [ "menu" ], "summary": "Edit a dish the acting chef owns (patch semantics).", "description": "Edit a dish the acting chef owns (patch semantics).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateDishRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/dishes/{dish_id}/favourite": { "delete": { "operationId": "deleteMenuDishesDishIdFavourite", "tags": [ "menu" ], "summary": "Remove a dish star.", "description": "Remove a dish star.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnfavouriteDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuDishesDishIdFavourite", "tags": [ "menu" ], "summary": "Star a dish for the acting profile.", "description": "Star a dish for the acting profile.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FavouriteDishRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FavouriteDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/dishes/{dish_id}/reviews": { "get": { "operationId": "getMenuDishesDishIdReviews", "tags": [ "menu" ], "summary": "List a dish's reviews.", "description": "List a dish's reviews.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListDishReviewsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuDishesDishIdReviews", "tags": [ "menu" ], "summary": "Add or update a dish-specific review.", "description": "Add or update a dish-specific review.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddDishReviewRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddDishReviewResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/dishes/{dish_id}/status": { "patch": { "operationId": "patchMenuDishesDishIdStatus", "tags": [ "menu" ], "summary": "Toggle a dish's availability.", "description": "Toggle a dish's availability.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetDishStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetDishStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/favourites": { "get": { "operationId": "getMenuFavourites", "tags": [ "menu" ], "summary": "List the acting profile's starred dishes.", "description": "List the acting profile's starred dishes.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListFavouriteDishesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plan-cycles/{cycle_id}/status": { "patch": { "operationId": "patchMenuMealPlanCyclesCycleIdStatus", "tags": [ "menu" ], "summary": "Confirm, skip, or close out one plan cycle.", "description": "Confirm, skip, or close out one plan cycle.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanCycleStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanCycleStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans": { "get": { "operationId": "getMenuMealPlans", "tags": [ "menu" ], "summary": "List the caller's meal plans.", "description": "List the caller's meal plans.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMealPlansResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuMealPlans", "tags": [ "menu" ], "summary": "Create a customer meal plan.", "description": "Create a customer meal plan.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMealPlanRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMealPlanResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans/{plan_id}": { "patch": { "operationId": "patchMenuMealPlansPlanId", "tags": [ "menu" ], "summary": "Edit a meal plan the acting profile owns (patch semantics).", "description": "Edit a meal plan the acting profile owns (patch semantics).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMealPlanRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMealPlanResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans/{plan_id}/cycles": { "get": { "operationId": "getMenuMealPlansPlanIdCycles", "tags": [ "menu" ], "summary": "List a meal plan's cycles.", "description": "List a meal plan's cycles.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMealPlanCyclesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuMealPlansPlanIdCycles", "tags": [ "menu" ], "summary": "Materialize upcoming cycles for a meal plan.", "description": "Materialize upcoming cycles for a meal plan.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateMealPlanCyclesRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateMealPlanCyclesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans/{plan_id}/entries": { "post": { "operationId": "postMenuMealPlansPlanIdEntries", "tags": [ "menu" ], "summary": "Put a dish onto a meal plan day/slot.", "description": "Put a dish onto a meal plan day/slot.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddMealPlanEntryRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddMealPlanEntryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans/{plan_id}/entries/{entry_id}": { "delete": { "operationId": "deleteMenuMealPlansPlanIdEntriesEntryId", "tags": [ "menu" ], "summary": "Remove a meal plan entry.", "description": "Remove a meal plan entry.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveMealPlanEntryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/meal-plans/{plan_id}/status": { "patch": { "operationId": "patchMenuMealPlansPlanIdStatus", "tags": [ "menu" ], "summary": "Activate, pause, or archive a meal plan.", "description": "Activate, pause, or archive a meal plan.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/menus": { "get": { "operationId": "getMenuMenus", "tags": [ "menu" ], "summary": "List a chef's menus.", "description": "List a chef's menus.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChefMenusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuMenus", "tags": [ "menu" ], "summary": "Create a chef menu (draft).", "description": "Create a chef menu (draft).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMenuRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMenuResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/menus/{menu_id}": { "delete": { "operationId": "deleteMenuMenusMenuId", "tags": [ "menu" ], "summary": "Permanently delete a chef menu and its attached dishes.", "description": "Permanently delete a chef menu and its attached dishes.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteMenuResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/menus/{menu_id}/dishes": { "get": { "operationId": "getMenuMenusMenuIdDishes", "tags": [ "menu" ], "summary": "List a menu's dishes.", "description": "List a menu's dishes.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListDishesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMenuMenusMenuIdDishes", "tags": [ "menu" ], "summary": "Add a dish to a chef menu.", "description": "Add a dish to a chef menu.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddDishRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddDishResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/menus/{menu_id}/status": { "patch": { "operationId": "patchMenuMenusMenuIdStatus", "tags": [ "menu" ], "summary": "Publish, pause, or archive a chef menu.", "description": "Publish, pause, or archive a chef menu.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishMenuRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishMenuResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/trending/chefs": { "get": { "operationId": "getMenuTrendingChefs", "tags": [ "menu" ], "summary": "List trending chefs derived from order demand.", "description": "List trending chefs derived from order demand.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListTrendingChefsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/menu/trending/dishes": { "get": { "operationId": "getMenuTrendingDishes", "tags": [ "menu" ], "summary": "List trending dishes derived from order demand.", "description": "List trending dishes derived from order demand.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListTrendingDishesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/messages/order-threads": { "post": { "operationId": "postMessagesOrderThreads", "tags": [ "messages" ], "summary": "Start an order-gated message thread.", "description": "Start an order-gated message thread.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartOrderThreadRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartOrderThreadResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/messages/order-threads/{thread_id}/messages": { "get": { "operationId": "getMessagesOrderThreadsThreadIdMessages", "tags": [ "messages" ], "summary": "List order-gated messages.", "description": "List order-gated messages.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListOrderMessagesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postMessagesOrderThreadsThreadIdMessages", "tags": [ "messages" ], "summary": "Send an order-gated message.", "description": "Send an order-gated message.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendOrderMessageRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendOrderMessageResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/notifications/settings": { "get": { "operationId": "getNotificationsSettings", "tags": [ "notifications" ], "summary": "Read Web Push availability.", "description": "Read Web Push availability.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetSettingsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/notifications/subscriptions": { "post": { "operationId": "postNotificationsSubscriptions", "tags": [ "notifications" ], "summary": "Register this browser for notifications.", "description": "Register this browser for notifications.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscribeRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscribeResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/notifications/test": { "post": { "operationId": "postNotificationsTest", "tags": [ "notifications" ], "summary": "Queue a test for the current browser.", "description": "Queue a test for the current browser.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TestRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TestResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/notifications/unsubscribe": { "post": { "operationId": "postNotificationsUnsubscribe", "tags": [ "notifications" ], "summary": "Remove this browser subscription.", "description": "Remove this browser subscription.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnsubscribeRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnsubscribeResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/offers": { "post": { "operationId": "postOffers", "tags": [ "offers" ], "summary": "Create a priced delivery offer for a rider.", "description": "Create a priced delivery offer for a rider.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateOfferRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateOfferResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/offers/{offer_id}/accept": { "post": { "operationId": "postOffersOfferIdAccept", "tags": [ "offers" ], "summary": "Accept a live delivery offer.", "description": "Accept a live delivery offer.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptOfferRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptOfferResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/offers/{offer_id}/decline": { "post": { "operationId": "postOffersOfferIdDecline", "tags": [ "offers" ], "summary": "Decline a live delivery offer.", "description": "Decline a live delivery offer.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeclineOfferRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeclineOfferResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/ops/deliveries/cancel": { "post": { "operationId": "postOpsDeliveriesCancel", "tags": [ "ops" ], "summary": "Cancel a delivery.", "description": "Cancel a delivery.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelDeliveryRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelDeliveryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/ops/deliveries/reassign": { "post": { "operationId": "postOpsDeliveriesReassign", "tags": [ "ops" ], "summary": "Reassign a delivery.", "description": "Reassign a delivery.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReassignDeliveryRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReassignDeliveryResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles": { "put": { "operationId": "putProfiles", "tags": [ "profiles" ], "summary": "Create or update a shared Chow profile.", "description": "Create or update a shared Chow profile.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpsertProfileRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpsertProfileResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}": { "get": { "operationId": "getProfilesProfileId", "tags": [ "profiles" ], "summary": "Get a shared Chow profile.", "description": "Get a shared Chow profile.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetProfileResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/links": { "post": { "operationId": "postProfilesProfileIdLinks", "tags": [ "profiles" ], "summary": "Link a shared profile to a domain entity.", "description": "Link a shared profile to a domain entity.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinkProfileRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinkProfileResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor": { "put": { "operationId": "putProfilesProfileIdVendor", "tags": [ "profiles" ], "summary": "Create or update a chef/vendor profile.", "description": "Create or update a chef/vendor profile.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorProfileRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorProfileResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor/locations": { "get": { "operationId": "getProfilesProfileIdVendorLocations", "tags": [ "profiles" ], "summary": "List a vendor's locations.", "description": "List a vendor's locations.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListVendorLocationsResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "put": { "operationId": "putProfilesProfileIdVendorLocations", "tags": [ "profiles" ], "summary": "Create or update one of a vendor's locations.", "description": "Create or update one of a vendor's locations.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorLocationRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorLocationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor/locations/{location_id}": { "delete": { "operationId": "deleteProfilesProfileIdVendorLocationsLocationId", "tags": [ "profiles" ], "summary": "Remove one of a vendor's locations.", "description": "Remove one of a vendor's locations.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteVendorLocationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor/meal-plan-optin": { "put": { "operationId": "putProfilesProfileIdVendorMealPlanOptin", "tags": [ "profiles" ], "summary": "Set chef meal-plan opt-in fields (spec 4.1).", "description": "Set chef meal-plan opt-in fields (spec 4.1).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanOptInRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMealPlanOptInResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor/schedule": { "put": { "operationId": "putProfilesProfileIdVendorSchedule", "tags": [ "profiles" ], "summary": "Set a chef/vendor weekly working schedule.", "description": "Set a chef/vendor weekly working schedule.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorScheduleRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorScheduleResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/profiles/{profile_id}/vendor/status": { "patch": { "operationId": "patchProfilesProfileIdVendorStatus", "tags": [ "profiles" ], "summary": "Set chef/vendor open status.", "description": "Set chef/vendor open status.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorStatusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetVendorStatusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/proof/dropoff": { "post": { "operationId": "postProofDropoff", "tags": [ "proof" ], "summary": "Confirm dropoff proof.", "description": "Confirm dropoff proof.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmDropoffProofRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmDropoffProofResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/proof/pickup": { "post": { "operationId": "postProofPickup", "tags": [ "proof" ], "summary": "Confirm pickup proof.", "description": "Confirm pickup proof.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPickupProofRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPickupProofResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/rider/dash/start": { "post": { "operationId": "postRiderDashStart", "tags": [ "rider" ], "summary": "Start a rider dash session.", "description": "Start a rider dash session.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartDashRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartDashResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/rider/dash/stop": { "post": { "operationId": "postRiderDashStop", "tags": [ "rider" ], "summary": "Stop a rider dash session.", "description": "Stop a rider dash session.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StopDashRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StopDashResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/rider/preferences": { "patch": { "operationId": "patchRiderPreferences", "tags": [ "rider" ], "summary": "Set rider vehicle and offer preferences.", "description": "Set rider vehicle and offer preferences.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetRiderPreferencesRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetRiderPreferencesResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/safety/sos": { "post": { "operationId": "postSafetySos", "tags": [ "safety" ], "summary": "Trigger rider SOS.", "description": "Trigger rider SOS.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerSosRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerSosResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/seo/kitchens": { "get": { "operationId": "getSeoKitchens", "tags": [ "seo" ], "summary": "Public: the kitchen index as JSON, for clients that want the data rather than the page.", "description": "Public: the kitchen index as JSON, for clients that want the data rather than the page.", "responses": { "200": { "description": "Kitchen index as JSON.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResult" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [] } }, "/v1/support/messages": { "post": { "operationId": "postSupportMessages", "tags": [ "support" ], "summary": "Send a support message.", "description": "Send a support message.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendSupportMessageRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendSupportMessageResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/user/account/deletion": { "delete": { "operationId": "deleteUserAccountDeletion", "tags": [ "user" ], "summary": "Cancel a scheduled account deletion.", "description": "Cancel a scheduled account deletion.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountDeletionStateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "getUserAccountDeletion", "tags": [ "user" ], "summary": "Read the signed-in account's deletion state.", "description": "Read the signed-in account's deletion state.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountDeletionStateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postUserAccountDeletion", "tags": [ "user" ], "summary": "Schedule deletion of the signed-in account after a grace period.", "description": "Schedule deletion of the signed-in account after a grace period.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestAccountDeletionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountDeletionStateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/documents": { "post": { "operationId": "postVerificationDocuments", "tags": [ "verification" ], "summary": "Upload one private verification document (ID, selfie, kitchen photo or video, certificate).", "description": "Upload one private verification document (ID, selfie, kitchen photo or video, certificate).", "responses": { "201": { "description": "Document stored privately and attached to the dossier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResult" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/documents/{key...}": { "get": { "operationId": "getVerificationDocumentsKey", "tags": [ "verification" ], "summary": "Stream a private verification document to its owner or a reviewer.", "description": "Stream a private verification document to its owner or a reviewer.", "responses": { "200": { "description": "Document bytes streamed with no-store caching.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StandardSuccessResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/hygiene-flags/{flag_id}/resolve": { "post": { "operationId": "postVerificationHygieneFlagsFlagIdResolve", "tags": [ "verification" ], "summary": "Uphold or dismiss a hygiene flag.", "description": "Uphold or dismiss a hygiene flag.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveHygieneFlagRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveHygieneFlagResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/hygiene-reports": { "post": { "operationId": "postVerificationHygieneReports", "tags": [ "verification" ], "summary": "Report a hygiene issue on a completed order.", "description": "Report a hygiene issue on a completed order.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportHygieneIssueRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportHygieneIssueResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/kitchens/{vendor_profile_id}": { "get": { "operationId": "getVerificationKitchensVendorProfileId", "tags": [ "verification" ], "summary": "Read a kitchen's dossier and review history.", "description": "Read a kitchen's dossier and review history.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetDossierResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/kitchens/{vendor_profile_id}/certificate": { "post": { "operationId": "postVerificationKitchensVendorProfileIdCertificate", "tags": [ "verification" ], "summary": "Approve or reject a food-handler certificate.", "description": "Approve or reject a food-handler certificate.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewCertificateRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewCertificateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/kitchens/{vendor_profile_id}/inspections": { "post": { "operationId": "postVerificationKitchensVendorProfileIdInspections", "tags": [ "verification" ], "summary": "Record an inspection of a kitchen.", "description": "Record an inspection of a kitchen.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordInspectionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordInspectionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/kitchens/{vendor_profile_id}/reinstate": { "post": { "operationId": "postVerificationKitchensVendorProfileIdReinstate", "tags": [ "verification" ], "summary": "Reinstate a suspended kitchen after remediation.", "description": "Reinstate a suspended kitchen after remediation.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReinstateKitchenRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReinstateKitchenResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/kitchens/{vendor_profile_id}/review": { "post": { "operationId": "postVerificationKitchensVendorProfileIdReview", "tags": [ "verification" ], "summary": "Approve or reject a verification submission.", "description": "Approve or reject a verification submission.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSubmissionRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSubmissionResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me": { "get": { "operationId": "getVerificationMe", "tags": [ "verification" ], "summary": "Read the signed-in chef's verification state and checklist.", "description": "Read the signed-in chef's verification state and checklist.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMyVerificationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me/agreement": { "post": { "operationId": "postVerificationMeAgreement", "tags": [ "verification" ], "summary": "Accept the current hygiene standards agreement.", "description": "Accept the current hygiene standards agreement.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptAgreementRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptAgreementResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me/phone/confirm": { "post": { "operationId": "postVerificationMePhoneConfirm", "tags": [ "verification" ], "summary": "Confirm the chef's phone with the one-time code.", "description": "Confirm the chef's phone with the one-time code.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPhoneOtpRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmPhoneOtpResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me/phone/otp": { "post": { "operationId": "postVerificationMePhoneOtp", "tags": [ "verification" ], "summary": "Send a one-time code to the chef's phone.", "description": "Send a one-time code to the chef's phone.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestPhoneOtpRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestPhoneOtpResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me/sick-pause": { "post": { "operationId": "postVerificationMeSickPause", "tags": [ "verification" ], "summary": "Pause or resume the kitchen for illness, without penalty.", "description": "Pause or resume the kitchen for illness, without penalty.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetSickPauseRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetSickPauseResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/me/submit": { "post": { "operationId": "postVerificationMeSubmit", "tags": [ "verification" ], "summary": "Submit the verification dossier for review.", "description": "Submit the verification dossier for review.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmitVerificationRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmitVerificationResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/verification/review-queue": { "get": { "operationId": "getVerificationReviewQueue", "tags": [ "verification" ], "summary": "List submissions and hygiene flags waiting for review.", "description": "List submissions and hygiene flags waiting for review.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListReviewQueueResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/wallet/balance": { "get": { "operationId": "getWalletBalance", "tags": [ "wallet" ], "summary": "Get rider wallet balance.", "description": "Get rider wallet balance.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetWalletBalanceResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/wallet/bonuses": { "post": { "operationId": "postWalletBonuses", "tags": [ "wallet" ], "summary": "Award a platform-funded rider bonus.", "description": "Award a platform-funded rider bonus.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AwardBonusRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AwardBonusResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/wallet/cashout": { "post": { "operationId": "postWalletCashout", "tags": [ "wallet" ], "summary": "Request rider cashout.", "description": "Request rider cashout.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestCashoutRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestCashoutResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/wallet/tips": { "post": { "operationId": "postWalletTips", "tags": [ "wallet" ], "summary": "Capture a 100 percent pass-through rider tip.", "description": "Capture a 100 percent pass-through rider tip.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaptureTipRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaptureTipResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "schemas": { "AcceptAgreementRequest": { "type": "object", "description": "Request body for verification:accept_agreement:v1:requested", "additionalProperties": {} }, "AcceptAgreementResponse": { "type": "object", "description": "Successful response for verification:accept_agreement:v1:requested", "additionalProperties": {} }, "AcceptOfferRequest": { "type": "object", "description": "Request body for offer:accept:v1:requested", "additionalProperties": {} }, "AcceptOfferResponse": { "type": "object", "description": "Successful response for offer:accept:v1:requested", "additionalProperties": {} }, "AccountDeletionStateResponse": { "type": "object", "description": "Successful response for user:cancel_account_deletion:v1:requested", "additionalProperties": {} }, "AddCartItemRequest": { "type": "object", "description": "Request body for marketplace:add_cart_item:v1:requested", "additionalProperties": {} }, "AddCartItemResponse": { "type": "object", "description": "Successful response for marketplace:add_cart_item:v1:requested", "additionalProperties": {} }, "AddDishRequest": { "type": "object", "description": "Request body for menu:add_dish:v1:requested", "additionalProperties": {} }, "AddDishResponse": { "type": "object", "description": "Successful response for menu:add_dish:v1:requested", "additionalProperties": {} }, "AddDishReviewRequest": { "type": "object", "description": "Request body for menu:add_dish_review:v1:requested", "additionalProperties": {} }, "AddDishReviewResponse": { "type": "object", "description": "Successful response for menu:add_dish_review:v1:requested", "additionalProperties": {} }, "AddMealPlanEntryRequest": { "type": "object", "description": "Request body for menu:add_meal_plan_entry:v1:requested", "additionalProperties": {} }, "AddMealPlanEntryResponse": { "type": "object", "description": "Successful response for menu:add_meal_plan_entry:v1:requested", "additionalProperties": {} }, "AdminSetVendorStatusRequest": { "type": "object", "description": "Request body for marketplace:admin_set_vendor_status:v1:requested", "additionalProperties": {} }, "AdminSetVendorStatusResponse": { "type": "object", "description": "Successful response for marketplace:admin_set_vendor_status:v1:requested", "additionalProperties": {} }, "AwardBonusRequest": { "type": "object", "description": "Request body for wallet:award_bonus:v1:requested", "additionalProperties": {} }, "AwardBonusResponse": { "type": "object", "description": "Successful response for wallet:award_bonus:v1:requested", "additionalProperties": {} }, "CancelDeliveryRequest": { "type": "object", "description": "Request body for ops:cancel:v1:requested", "additionalProperties": {} }, "CancelDeliveryResponse": { "type": "object", "description": "Successful response for ops:cancel:v1:requested", "additionalProperties": {} }, "CancelSubscriptionRequest": { "type": "object", "description": "Request body for billing:cancel_subscription:v1:requested", "additionalProperties": {} }, "CancelSubscriptionResponse": { "type": "object", "description": "Successful response for billing:cancel_subscription:v1:requested", "additionalProperties": {} }, "CaptureTipRequest": { "type": "object", "description": "Request body for wallet:capture_tip:v1:requested", "additionalProperties": {} }, "CaptureTipResponse": { "type": "object", "description": "Successful response for wallet:capture_tip:v1:requested", "additionalProperties": {} }, "CheckoutCartRequest": { "type": "object", "description": "Request body for marketplace:checkout_cart:v1:requested", "additionalProperties": {} }, "CheckoutCartResponse": { "type": "object", "description": "Successful response for marketplace:checkout_cart:v1:requested", "additionalProperties": {} }, "ChefExitRequest": { "type": "object", "description": "Request body for mealplan:chef_exit:v1:requested", "additionalProperties": {} }, "ChefExitResponse": { "type": "object", "description": "Successful response for mealplan:chef_exit:v1:requested", "additionalProperties": {} }, "ConfirmDropoffProofRequest": { "type": "object", "description": "Request body for proof:confirm_dropoff_proof:v1:requested", "additionalProperties": {} }, "ConfirmDropoffProofResponse": { "type": "object", "description": "Successful response for proof:confirm_dropoff_proof:v1:requested", "additionalProperties": {} }, "ConfirmPaymentRequest": { "type": "object", "description": "Request body for billing:confirm_payment:v1:requested", "additionalProperties": {} }, "ConfirmPaymentResponse": { "type": "object", "description": "Successful response for billing:confirm_payment:v1:requested", "additionalProperties": {} }, "ConfirmPhoneOtpRequest": { "type": "object", "description": "Request body for verification:confirm_phone_otp:v1:requested", "additionalProperties": {} }, "ConfirmPhoneOtpResponse": { "type": "object", "description": "Successful response for verification:confirm_phone_otp:v1:requested", "additionalProperties": {} }, "ConfirmPickupProofRequest": { "type": "object", "description": "Request body for proof:confirm_pickup_proof:v1:requested", "additionalProperties": {} }, "ConfirmPickupProofResponse": { "type": "object", "description": "Successful response for proof:confirm_pickup_proof:v1:requested", "additionalProperties": {} }, "CreateCheckoutSessionRequest": { "type": "object", "description": "Request body for billing:create_checkout_session:v1:requested", "additionalProperties": {} }, "CreateCheckoutSessionResponse": { "type": "object", "description": "Successful response for billing:create_checkout_session:v1:requested", "additionalProperties": {} }, "CreateDeliveryRequest": { "type": "object", "description": "Request body for delivery:create_delivery:v1:requested", "additionalProperties": {} }, "CreateDeliveryResponse": { "type": "object", "description": "Successful response for delivery:create_delivery:v1:requested", "additionalProperties": {} }, "CreateDishRequest": { "type": "object", "description": "Request body for menu:create_dish:v1:requested", "additionalProperties": {} }, "CreateDishResponse": { "type": "object", "description": "Successful response for menu:create_dish:v1:requested", "additionalProperties": {} }, "CreateHelpTicketRequest": { "type": "object", "description": "Request body for assist:create_help_ticket:v1:requested", "additionalProperties": {} }, "CreateHelpTicketResponse": { "type": "object", "description": "Successful response for assist:create_help_ticket:v1:requested", "additionalProperties": {} }, "CreateMealPlanRequest": { "type": "object", "description": "Request body for menu:create_meal_plan:v1:requested", "additionalProperties": {} }, "CreateMealPlanResponse": { "type": "object", "description": "Successful response for menu:create_meal_plan:v1:requested", "additionalProperties": {} }, "CreateMenuRequest": { "type": "object", "description": "Request body for menu:create_menu:v1:requested", "additionalProperties": {} }, "CreateMenuResponse": { "type": "object", "description": "Successful response for menu:create_menu:v1:requested", "additionalProperties": {} }, "CreateOfferRequest": { "type": "object", "description": "Request body for offer:create:v1:requested", "additionalProperties": {} }, "CreateOfferResponse": { "type": "object", "description": "Successful response for offer:create:v1:requested", "additionalProperties": {} }, "CreatePromoRequest": { "type": "object", "description": "Request body for marketplace:create_promo:v1:requested", "additionalProperties": {} }, "CreatePromoResponse": { "type": "object", "description": "Successful response for marketplace:create_promo:v1:requested", "additionalProperties": {} }, "CreateReservationRequest": { "type": "object", "description": "Request body for marketplace:create_reservation:v1:requested", "additionalProperties": {} }, "CreateReservationResponse": { "type": "object", "description": "Successful response for marketplace:create_reservation:v1:requested", "additionalProperties": {} }, "CreateSubscriptionRequest": { "type": "object", "description": "Request body for billing:create_subscription:v1:requested", "additionalProperties": {} }, "CreateSubscriptionResponse": { "type": "object", "description": "Successful response for billing:create_subscription:v1:requested", "additionalProperties": {} }, "CreateZoneRequest": { "type": "object", "description": "Request body for mealplan:create_zone:v1:requested", "additionalProperties": {} }, "CreateZoneResponse": { "type": "object", "description": "Successful response for mealplan:create_zone:v1:requested", "additionalProperties": {} }, "DeclineOfferRequest": { "type": "object", "description": "Request body for offer:decline:v1:requested", "additionalProperties": {} }, "DeclineOfferResponse": { "type": "object", "description": "Successful response for offer:decline:v1:requested", "additionalProperties": {} }, "DeleteDishResponse": { "type": "object", "description": "Successful response for menu:delete_dish:v1:requested", "additionalProperties": {} }, "DeleteMenuResponse": { "type": "object", "description": "Successful response for menu:delete_menu:v1:requested", "additionalProperties": {} }, "DeleteVendorLocationResponse": { "type": "object", "description": "Successful response for profile:delete_vendor_location:v1:requested", "additionalProperties": {} }, "DeliverDropRequest": { "type": "object", "description": "Request body for mealplan:deliver_drop:v1:requested", "additionalProperties": {} }, "DeliverDropResponse": { "type": "object", "description": "Successful response for mealplan:deliver_drop:v1:requested", "additionalProperties": {} }, "ErrorResponse": { "type": "object", "properties": { "code": { "type": "string", "example": "BAD_REQUEST" }, "details": { "type": "object", "additionalProperties": {} }, "error": { "type": "string", "example": "validation failed" } }, "required": [ "error" ] }, "EscalateHelpTicketRequest": { "type": "object", "description": "Request body for assist:escalate_help_ticket:v1:requested", "additionalProperties": {} }, "EscalateHelpTicketResponse": { "type": "object", "description": "Successful response for assist:escalate_help_ticket:v1:requested", "additionalProperties": {} }, "EstimateRouteRequest": { "type": "object", "description": "Request body for maps:estimate_route:v1:requested", "additionalProperties": {} }, "EstimateRouteResponse": { "type": "object", "description": "Successful response for maps:estimate_route:v1:requested", "additionalProperties": {} }, "FailDropRequest": { "type": "object", "description": "Request body for mealplan:fail_drop:v1:requested", "additionalProperties": {} }, "FailDropResponse": { "type": "object", "description": "Successful response for mealplan:fail_drop:v1:requested", "additionalProperties": {} }, "FavouriteDishRequest": { "type": "object", "description": "Request body for menu:favourite_dish:v1:requested", "additionalProperties": {} }, "FavouriteDishResponse": { "type": "object", "description": "Successful response for menu:favourite_dish:v1:requested", "additionalProperties": {} }, "GenerateMealPlanCyclesRequest": { "type": "object", "description": "Request body for menu:generate_meal_plan_cycles:v1:requested", "additionalProperties": {} }, "GenerateMealPlanCyclesResponse": { "type": "object", "description": "Successful response for menu:generate_meal_plan_cycles:v1:requested", "additionalProperties": {} }, "GetActiveDeliveryResponse": { "type": "object", "description": "Successful response for delivery:get_active:v1:requested", "additionalProperties": {} }, "GetDishResponse": { "type": "object", "description": "Successful response for menu:get_dish:v1:requested", "additionalProperties": {} }, "GetDossierResponse": { "type": "object", "description": "Successful response for verification:get_dossier:v1:requested", "additionalProperties": {} }, "GetMyVerificationResponse": { "type": "object", "description": "Successful response for verification:get_my_verification:v1:requested", "additionalProperties": {} }, "GetOrderResponse": { "type": "object", "description": "Successful response for marketplace:get_order:v1:requested", "additionalProperties": {} }, "GetProfileResponse": { "type": "object", "description": "Successful response for profile:get_profile:v1:requested", "additionalProperties": {} }, "GetProfileWalletBalanceResponse": { "type": "object", "description": "Successful response for billing:get_profile_wallet_balance:v1:requested", "additionalProperties": {} }, "GetRatesResponse": { "type": "object", "description": "Successful response for mealplan:get_rates:v1:requested", "additionalProperties": {} }, "GetSettingsResponse": { "type": "object", "description": "Successful response for notification:get_settings:v1:requested", "additionalProperties": {} }, "GetWalletBalanceResponse": { "type": "object", "description": "Successful response for wallet:get_balance:v1:requested", "additionalProperties": {} }, "LinkProfileRequest": { "type": "object", "description": "Request body for profile:link_profile:v1:requested", "additionalProperties": {} }, "LinkProfileResponse": { "type": "object", "description": "Successful response for profile:link_profile:v1:requested", "additionalProperties": {} }, "ListChefDishesResponse": { "type": "object", "description": "Successful response for menu:list_chef_dishes:v1:requested", "additionalProperties": {} }, "ListChefMenusResponse": { "type": "object", "description": "Successful response for menu:list_chef_menus:v1:requested", "additionalProperties": {} }, "ListDishReviewsResponse": { "type": "object", "description": "Successful response for menu:list_dish_reviews:v1:requested", "additionalProperties": {} }, "ListDishesResponse": { "type": "object", "description": "Successful response for menu:list_dishes:v1:requested", "additionalProperties": {} }, "ListDropsResponse": { "type": "object", "description": "Successful response for mealplan:list_drops:v1:requested", "additionalProperties": {} }, "ListFavouriteDishesResponse": { "type": "object", "description": "Successful response for menu:list_favourite_dishes:v1:requested", "additionalProperties": {} }, "ListMealPlanCyclesResponse": { "type": "object", "description": "Successful response for menu:list_meal_plan_cycles:v1:requested", "additionalProperties": {} }, "ListMealPlansResponse": { "type": "object", "description": "Successful response for menu:list_meal_plans:v1:requested", "additionalProperties": {} }, "ListOrderMessagesResponse": { "type": "object", "description": "Successful response for message:list_order_messages:v1:requested", "additionalProperties": {} }, "ListPromosResponse": { "type": "object", "description": "Successful response for marketplace:list_promos:v1:requested", "additionalProperties": {} }, "ListReviewQueueResponse": { "type": "object", "description": "Successful response for verification:list_review_queue:v1:requested", "additionalProperties": {} }, "ListSubscriptionPlansResponse": { "type": "object", "description": "Successful response for billing:list_subscription_plans:v1:requested", "additionalProperties": {} }, "ListSubscriptionsResponse": { "type": "object", "description": "Successful response for mealplan:list_subscriptions:v1:requested", "additionalProperties": {} }, "ListTrendingChefsResponse": { "type": "object", "description": "Successful response for menu:list_trending_chefs:v1:requested", "additionalProperties": {} }, "ListTrendingDishesResponse": { "type": "object", "description": "Successful response for menu:list_trending_dishes:v1:requested", "additionalProperties": {} }, "ListVendorLocationsResponse": { "type": "object", "description": "Successful response for profile:list_vendor_locations:v1:requested", "additionalProperties": {} }, "ListZonesResponse": { "type": "object", "description": "Successful response for mealplan:list_zones:v1:requested", "additionalProperties": {} }, "PaginatedResult": { "type": "object", "properties": { "items": { "type": "array", "items": {} }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "Pagination": { "type": "object", "properties": { "next_page_token": { "type": "string", "example": "cursor:def456" }, "page_size": { "type": "integer", "format": "int32", "example": 50 }, "page_token": { "type": "string", "example": "cursor:abc123" }, "total_count": { "type": "integer", "format": "int64", "example": 120 } } }, "PauseSubscriptionRequest": { "type": "object", "description": "Request body for mealplan:pause_subscription:v1:requested", "additionalProperties": {} }, "PauseSubscriptionResponse": { "type": "object", "description": "Successful response for mealplan:pause_subscription:v1:requested", "additionalProperties": {} }, "PublishMenuRequest": { "type": "object", "description": "Request body for menu:publish_menu:v1:requested", "additionalProperties": {} }, "PublishMenuResponse": { "type": "object", "description": "Successful response for menu:publish_menu:v1:requested", "additionalProperties": {} }, "QuotePromoRequest": { "type": "object", "description": "Request body for marketplace:quote_promo:v1:requested", "additionalProperties": {} }, "QuotePromoResponse": { "type": "object", "description": "Successful response for marketplace:quote_promo:v1:requested", "additionalProperties": {} }, "QuoteRequest": { "type": "object", "description": "Request body for mealplan:quote:v1:requested", "additionalProperties": {} }, "QuoteResponse": { "type": "object", "description": "Successful response for mealplan:quote:v1:requested", "additionalProperties": {} }, "RankOfferCandidatesRequest": { "type": "object", "description": "Request body for logistics:rank_offer_candidates:v1:requested", "additionalProperties": {} }, "RankOfferCandidatesResponse": { "type": "object", "description": "Successful response for logistics:rank_offer_candidates:v1:requested", "additionalProperties": {} }, "ReassignDeliveryRequest": { "type": "object", "description": "Request body for ops:reassign:v1:requested", "additionalProperties": {} }, "ReassignDeliveryResponse": { "type": "object", "description": "Successful response for ops:reassign:v1:requested", "additionalProperties": {} }, "RecordAIResolutionRequest": { "type": "object", "description": "Request body for assist:record_ai_resolution:v1:requested", "additionalProperties": {} }, "RecordAIResolutionResponse": { "type": "object", "description": "Successful response for assist:record_ai_resolution:v1:requested", "additionalProperties": {} }, "RecordInspectionRequest": { "type": "object", "description": "Request body for verification:record_inspection:v1:requested", "additionalProperties": {} }, "RecordInspectionResponse": { "type": "object", "description": "Successful response for verification:record_inspection:v1:requested", "additionalProperties": {} }, "ReinstateKitchenRequest": { "type": "object", "description": "Request body for verification:reinstate_kitchen:v1:requested", "additionalProperties": {} }, "ReinstateKitchenResponse": { "type": "object", "description": "Successful response for verification:reinstate_kitchen:v1:requested", "additionalProperties": {} }, "RemoveMealPlanEntryResponse": { "type": "object", "description": "Successful response for menu:remove_meal_plan_entry:v1:requested", "additionalProperties": {} }, "ReportHygieneIssueRequest": { "type": "object", "description": "Request body for verification:report_hygiene_issue:v1:requested", "additionalProperties": {} }, "ReportHygieneIssueResponse": { "type": "object", "description": "Successful response for verification:report_hygiene_issue:v1:requested", "additionalProperties": {} }, "RequestAccountDeletionRequest": { "type": "object", "description": "Request body for user:request_account_deletion:v1:requested", "additionalProperties": {} }, "RequestCashoutRequest": { "type": "object", "description": "Request body for wallet:request_cashout:v1:requested", "additionalProperties": {} }, "RequestCashoutResponse": { "type": "object", "description": "Successful response for wallet:request_cashout:v1:requested", "additionalProperties": {} }, "RequestPhoneOtpRequest": { "type": "object", "description": "Request body for verification:request_phone_otp:v1:requested", "additionalProperties": {} }, "RequestPhoneOtpResponse": { "type": "object", "description": "Successful response for verification:request_phone_otp:v1:requested", "additionalProperties": {} }, "RequestProfileCashoutRequest": { "type": "object", "description": "Request body for billing:request_profile_cashout:v1:requested", "additionalProperties": {} }, "RequestProfileCashoutResponse": { "type": "object", "description": "Successful response for billing:request_profile_cashout:v1:requested", "additionalProperties": {} }, "RequestRefundRequest": { "type": "object", "description": "Request body for billing:request_refund:v1:requested", "additionalProperties": {} }, "RequestRefundResponse": { "type": "object", "description": "Successful response for billing:request_refund:v1:requested", "additionalProperties": {} }, "ResolveHygieneFlagRequest": { "type": "object", "description": "Request body for verification:resolve_hygiene_flag:v1:requested", "additionalProperties": {} }, "ResolveHygieneFlagResponse": { "type": "object", "description": "Successful response for verification:resolve_hygiene_flag:v1:requested", "additionalProperties": {} }, "ResumeSubscriptionRequest": { "type": "object", "description": "Request body for mealplan:resume_subscription:v1:requested", "additionalProperties": {} }, "ResumeSubscriptionResponse": { "type": "object", "description": "Successful response for mealplan:resume_subscription:v1:requested", "additionalProperties": {} }, "ReviewCertificateRequest": { "type": "object", "description": "Request body for verification:review_certificate:v1:requested", "additionalProperties": {} }, "ReviewCertificateResponse": { "type": "object", "description": "Successful response for verification:review_certificate:v1:requested", "additionalProperties": {} }, "ReviewSubmissionRequest": { "type": "object", "description": "Request body for verification:review_submission:v1:requested", "additionalProperties": {} }, "ReviewSubmissionResponse": { "type": "object", "description": "Successful response for verification:review_submission:v1:requested", "additionalProperties": {} }, "SendOrderMessageRequest": { "type": "object", "description": "Request body for message:send_order_message:v1:requested", "additionalProperties": {} }, "SendOrderMessageResponse": { "type": "object", "description": "Successful response for message:send_order_message:v1:requested", "additionalProperties": {} }, "SendSupportMessageRequest": { "type": "object", "description": "Request body for support:send:v1:requested", "additionalProperties": {} }, "SendSupportMessageResponse": { "type": "object", "description": "Successful response for support:send:v1:requested", "additionalProperties": {} }, "SetDishStatusRequest": { "type": "object", "description": "Request body for menu:set_dish_status:v1:requested", "additionalProperties": {} }, "SetDishStatusResponse": { "type": "object", "description": "Successful response for menu:set_dish_status:v1:requested", "additionalProperties": {} }, "SetMealPlanCycleStatusRequest": { "type": "object", "description": "Request body for menu:set_meal_plan_cycle_status:v1:requested", "additionalProperties": {} }, "SetMealPlanCycleStatusResponse": { "type": "object", "description": "Successful response for menu:set_meal_plan_cycle_status:v1:requested", "additionalProperties": {} }, "SetMealPlanOptInRequest": { "type": "object", "description": "Request body for profile:set_meal_plan_optin:v1:requested", "additionalProperties": {} }, "SetMealPlanOptInResponse": { "type": "object", "description": "Successful response for profile:set_meal_plan_optin:v1:requested", "additionalProperties": {} }, "SetMealPlanStatusRequest": { "type": "object", "description": "Request body for menu:set_meal_plan_status:v1:requested", "additionalProperties": {} }, "SetMealPlanStatusResponse": { "type": "object", "description": "Successful response for menu:set_meal_plan_status:v1:requested", "additionalProperties": {} }, "SetOrderStatusRequest": { "type": "object", "description": "Request body for marketplace:set_order_status:v1:requested", "additionalProperties": {} }, "SetOrderStatusResponse": { "type": "object", "description": "Successful response for marketplace:set_order_status:v1:requested", "additionalProperties": {} }, "SetPromoStatusRequest": { "type": "object", "description": "Request body for marketplace:set_promo_status:v1:requested", "additionalProperties": {} }, "SetPromoStatusResponse": { "type": "object", "description": "Successful response for marketplace:set_promo_status:v1:requested", "additionalProperties": {} }, "SetRatesRequest": { "type": "object", "description": "Request body for mealplan:set_rates:v1:requested", "additionalProperties": {} }, "SetRatesResponse": { "type": "object", "description": "Successful response for mealplan:set_rates:v1:requested", "additionalProperties": {} }, "SetRiderPreferencesRequest": { "type": "object", "description": "Request body for rider:set:v1:requested", "additionalProperties": {} }, "SetRiderPreferencesResponse": { "type": "object", "description": "Successful response for rider:set:v1:requested", "additionalProperties": {} }, "SetSickPauseRequest": { "type": "object", "description": "Request body for verification:set_sick_pause:v1:requested", "additionalProperties": {} }, "SetSickPauseResponse": { "type": "object", "description": "Successful response for verification:set_sick_pause:v1:requested", "additionalProperties": {} }, "SetVendorLocationRequest": { "type": "object", "description": "Request body for profile:set_vendor_location:v1:requested", "additionalProperties": {} }, "SetVendorLocationResponse": { "type": "object", "description": "Successful response for profile:set_vendor_location:v1:requested", "additionalProperties": {} }, "SetVendorProfileRequest": { "type": "object", "description": "Request body for profile:set_vendor_profile:v1:requested", "additionalProperties": {} }, "SetVendorProfileResponse": { "type": "object", "description": "Successful response for profile:set_vendor_profile:v1:requested", "additionalProperties": {} }, "SetVendorScheduleRequest": { "type": "object", "description": "Request body for profile:set_vendor_schedule:v1:requested", "additionalProperties": {} }, "SetVendorScheduleResponse": { "type": "object", "description": "Successful response for profile:set_vendor_schedule:v1:requested", "additionalProperties": {} }, "SetVendorStatusRequest": { "type": "object", "description": "Request body for profile:set_vendor_status:v1:requested", "additionalProperties": {} }, "SetVendorStatusResponse": { "type": "object", "description": "Successful response for profile:set_vendor_status:v1:requested", "additionalProperties": {} }, "SkipDropRequest": { "type": "object", "description": "Request body for mealplan:skip_drop:v1:requested", "additionalProperties": {} }, "SkipDropResponse": { "type": "object", "description": "Successful response for mealplan:skip_drop:v1:requested", "additionalProperties": {} }, "StandardSuccessResponse": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": {} }, "message": { "type": "string", "example": "Successful response" }, "status": { "type": "string", "example": "ok" } } }, "StartDashRequest": { "type": "object", "description": "Request body for rider:start:v1:requested", "additionalProperties": {} }, "StartDashResponse": { "type": "object", "description": "Successful response for rider:start:v1:requested", "additionalProperties": {} }, "StartOrderThreadRequest": { "type": "object", "description": "Request body for message:start_order_thread:v1:requested", "additionalProperties": {} }, "StartOrderThreadResponse": { "type": "object", "description": "Successful response for message:start_order_thread:v1:requested", "additionalProperties": {} }, "StopDashRequest": { "type": "object", "description": "Request body for rider:stop:v1:requested", "additionalProperties": {} }, "StopDashResponse": { "type": "object", "description": "Successful response for rider:stop:v1:requested", "additionalProperties": {} }, "SubmitVerificationRequest": { "type": "object", "description": "Request body for verification:submit_verification:v1:requested", "additionalProperties": {} }, "SubmitVerificationResponse": { "type": "object", "description": "Successful response for verification:submit_verification:v1:requested", "additionalProperties": {} }, "SubscribeRequest": { "type": "object", "description": "Request body for mealplan:subscribe:v1:requested", "additionalProperties": {} }, "SubscribeResponse": { "type": "object", "description": "Successful response for mealplan:subscribe:v1:requested", "additionalProperties": {} }, "SyncDeliveryRouteRequest": { "type": "object", "description": "Request body for maps:sync:v1:requested", "additionalProperties": {} }, "SyncDeliveryRouteResponse": { "type": "object", "description": "Successful response for maps:sync:v1:requested", "additionalProperties": {} }, "TestRequest": { "type": "object", "description": "Request body for notification:test:v1:requested", "additionalProperties": {} }, "TestResponse": { "type": "object", "description": "Successful response for notification:test:v1:requested", "additionalProperties": {} }, "TransitionDeliveryRequest": { "type": "object", "description": "Request body for delivery:transition:v1:requested", "additionalProperties": {} }, "TransitionDeliveryResponse": { "type": "object", "description": "Successful response for delivery:transition:v1:requested", "additionalProperties": {} }, "TriggerSosRequest": { "type": "object", "description": "Request body for safety:trigger_sos:v1:requested", "additionalProperties": {} }, "TriggerSosResponse": { "type": "object", "description": "Successful response for safety:trigger_sos:v1:requested", "additionalProperties": {} }, "UnfavouriteDishResponse": { "type": "object", "description": "Successful response for menu:unfavourite_dish:v1:requested", "additionalProperties": {} }, "UnsubscribeRequest": { "type": "object", "description": "Request body for notification:unsubscribe:v1:requested", "additionalProperties": {} }, "UnsubscribeResponse": { "type": "object", "description": "Successful response for notification:unsubscribe:v1:requested", "additionalProperties": {} }, "UpdateDishRequest": { "type": "object", "description": "Request body for menu:update_dish:v1:requested", "additionalProperties": {} }, "UpdateDishResponse": { "type": "object", "description": "Successful response for menu:update_dish:v1:requested", "additionalProperties": {} }, "UpdateMealPlanRequest": { "type": "object", "description": "Request body for menu:update_meal_plan:v1:requested", "additionalProperties": {} }, "UpdateMealPlanResponse": { "type": "object", "description": "Successful response for menu:update_meal_plan:v1:requested", "additionalProperties": {} }, "UpdateRiderLocationRequest": { "type": "object", "description": "Request body for logistics:update:v1:requested", "additionalProperties": {} }, "UpdateRiderLocationResponse": { "type": "object", "description": "Successful response for logistics:update:v1:requested", "additionalProperties": {} }, "UpsertProfileRequest": { "type": "object", "description": "Request body for profile:upsert_profile:v1:requested", "additionalProperties": {} }, "UpsertProfileResponse": { "type": "object", "description": "Successful response for profile:upsert_profile:v1:requested", "additionalProperties": {} } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "JWT bearer token. Example: Authorization: Bearer \u003ctoken\u003e" } } }, "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "admin" }, { "name": "assist" }, { "name": "billing" }, { "name": "deliveries" }, { "name": "discover" }, { "name": "dish" }, { "name": "kitchen" }, { "name": "kitchens" }, { "name": "llms.txt" }, { "name": "logistics" }, { "name": "maps" }, { "name": "marketplace" }, { "name": "meal-plans" }, { "name": "media" }, { "name": "menu" }, { "name": "messages" }, { "name": "notifications" }, { "name": "offers" }, { "name": "ops" }, { "name": "profiles" }, { "name": "proof" }, { "name": "rider" }, { "name": "robots.txt" }, { "name": "safety" }, { "name": "seo" }, { "name": "sitemap.xml" }, { "name": "support" }, { "name": "user" }, { "name": "verification" }, { "name": "wallet" } ] }