{
  "openapi": "3.0.0",
  "info": {
    "title": "chowdash_rider_v1 API",
    "version": "1.1.0",
    "description": "API documentation for chowdash_rider_v1"
  },
  "paths": {
    "/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.",
        "description": "Public: verified chefs/vendors for the discovery/landing surface.",
        "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/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/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": {
      "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}": {
      "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"
                }
              }
            }
          }
        }
      }
    },
    "/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}/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}/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/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/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/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": {
      "AcceptOfferRequest": {
        "type": "object",
        "description": "Request body for offer:accept:v1:requested",
        "additionalProperties": {}
      },
      "AcceptOfferResponse": {
        "type": "object",
        "description": "Successful response for offer:accept: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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "RemoveMealPlanEntryResponse": {
        "type": "object",
        "description": "Successful response for menu:remove_meal_plan_entry: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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": {}
      },
      "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": "logistics"
    },
    {
      "name": "maps"
    },
    {
      "name": "marketplace"
    },
    {
      "name": "meal-plans"
    },
    {
      "name": "media"
    },
    {
      "name": "menu"
    },
    {
      "name": "messages"
    },
    {
      "name": "offers"
    },
    {
      "name": "ops"
    },
    {
      "name": "profiles"
    },
    {
      "name": "proof"
    },
    {
      "name": "rider"
    },
    {
      "name": "safety"
    },
    {
      "name": "support"
    },
    {
      "name": "wallet"
    }
  ]
}
