{"openapi":"3.1.0","info":{"title":"farm-to-door API","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Health","operationId":"health__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/farms":{"get":{"summary":"List Farms","operationId":"list_farms_farms_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"practice","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Practice"}},{"name":"specialty","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialty"}},{"name":"attribute","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribute"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"name","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/summary":{"get":{"summary":"List Farm Summaries","operationId":"list_farm_summaries_farms_summary_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}},{"name":"origin_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lat"}},{"name":"origin_lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lng"}},{"name":"radius_miles","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Miles"}},{"name":"north","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"North"}},{"name":"south","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"South"}},{"name":"east","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"East"}},{"name":"west","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"West"}},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Offset"}},{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/pins":{"get":{"summary":"List Farm Pins","operationId":"list_farm_pins_farms_pins_get","parameters":[{"name":"origin_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lat"}},{"name":"origin_lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lng"}},{"name":"radius_miles","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Miles"}},{"name":"north","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"North"}},{"name":"south","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"South"}},{"name":"east","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"East"}},{"name":"west","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"West"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}},{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/summary/counts":{"get":{"summary":"Get Farm Filter Counts","operationId":"get_farm_filter_counts_farms_summary_counts_get","parameters":[{"name":"origin_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lat"}},{"name":"origin_lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lng"}},{"name":"radius_miles","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Miles"}},{"name":"north","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"North"}},{"name":"south","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"South"}},{"name":"east","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"East"}},{"name":"west","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"West"}},{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/nearby":{"get":{"summary":"List Nearby Farm Summaries","operationId":"list_nearby_farm_summaries_farms_nearby_get","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","title":"Lat"}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","title":"Lng"}},{"name":"radius_miles","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Miles"}},{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/search":{"get":{"summary":"Search Farms Endpoint","description":"Whole-directory, proximity-ranked free-text search powering the top-of-page\nsearch box. Favors farms near the user's active location but falls back to\nstrong matches anywhere when nothing local fits. Pass origin_lat/origin_lng\nonly for a REAL user location (not the map's default seed) to get the geo\nbias; omit them for pure nationwide relevance.","operationId":"search_farms_endpoint_farms_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"origin_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lat"}},{"name":"origin_lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Origin Lng"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/count":{"get":{"summary":"Get Farm Count","operationId":"get_farm_count_farms_count_get","parameters":[{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/all":{"get":{"summary":"List All Farm Summaries","operationId":"list_all_farm_summaries_farms_all_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"after_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Id"}},{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/{farm_id}":{"get":{"summary":"Get Farm","operationId":"get_farm_farms__farm_id__get","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/saved-farms/ids":{"get":{"summary":"List Saved Farm Ids","operationId":"list_saved_farm_ids_saved_farms_ids_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/saved-farms":{"get":{"summary":"List Saved Farms","operationId":"list_saved_farms_saved_farms_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/saved-farms/{farm_id}":{"put":{"summary":"Save Farm","operationId":"save_farm_saved_farms__farm_id__put","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Unsave Farm","operationId":"unsave_farm_saved_farms__farm_id__delete","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/{farm_id}/reviews":{"get":{"summary":"List Farm Reviews","operationId":"list_farm_reviews_farms__farm_id__reviews_get","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Create Or Update Farm Review","operationId":"create_or_update_farm_review_farms__farm_id__reviews_post","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FarmReviewIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/{farm_id}/reviews/me":{"get":{"summary":"Get My Farm Review","operationId":"get_my_farm_review_farms__farm_id__reviews_me_get","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete My Farm Review","operationId":"delete_my_farm_review_farms__farm_id__reviews_me_delete","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farm-reviews/{review_id}/report":{"post":{"summary":"Report Farm Review","operationId":"report_farm_review_farm_reviews__review_id__report_post","parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","title":"Review Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FarmReviewReportIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/categories":{"get":{"summary":"Get Categories","operationId":"get_categories_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/practices":{"get":{"summary":"Get Practices","operationId":"get_practices_practices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/specialties":{"get":{"summary":"Get Specialties","operationId":"get_specialties_specialties_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/attributes":{"get":{"summary":"Get Attributes","operationId":"get_attributes_attributes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/states":{"get":{"summary":"Get States","operationId":"get_states_states_get","parameters":[{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seasonal":{"get":{"summary":"Get Seasonal","operationId":"get_seasonal_seasonal_get","parameters":[{"name":"X-Cache-Bypass","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cache-Bypass"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recipes":{"get":{"summary":"List Recipes","operationId":"list_recipes_recipes_get","parameters":[{"name":"ingredient","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingredient"}},{"name":"farm_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Farm Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inquiries":{"get":{"summary":"List Inquiries","operationId":"list_inquiries_inquiries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Create Inquiry","operationId":"create_inquiry_inquiries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alert-requests":{"post":{"summary":"Create Alert Request","operationId":"create_alert_request_alert_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRequestIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/low-result-farm-alerts":{"post":{"summary":"Create Low Result Farm Alert","operationId":"create_low_result_farm_alert_low_result_farm_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LowResultFarmAlertIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farms/{farm_id}/suggest-update":{"post":{"summary":"Suggest Farm Update","operationId":"suggest_farm_update_farms__farm_id__suggest_update_post","parameters":[{"name":"farm_id","in":"path","required":true,"schema":{"type":"string","title":"Farm Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FarmUpdateSuggestionIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farm-listings":{"post":{"summary":"Create Farm Listing","operationId":"create_farm_listing_farm_listings_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FarmListingIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"List Farm Listings","operationId":"list_farm_listings_farm_listings_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"pending","title":"Status"}},{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/reviews":{"get":{"summary":"List Admin Reviews","operationId":"list_admin_reviews_admin_reviews_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"published","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":100,"title":"Limit"}},{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/reviews/{review_id}":{"patch":{"summary":"Update Admin Review","operationId":"update_admin_review_admin_reviews__review_id__patch","parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","title":"Review Id"}},{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FarmReviewAdminUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/ops/metrics":{"get":{"summary":"Admin Ops Metrics","description":"Surface 5 dashboard metrics: cache hit rate, API p95 latency, farm opens,\nlisting submissions, delivery starts. Cheap in-process telemetry + PostHog\nHogQL for behavioral events. Returns nulls when a source is unconfigured.","operationId":"admin_ops_metrics_admin_ops_metrics_get","parameters":[{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/cache/status":{"get":{"summary":"Internal Cache Status","operationId":"internal_cache_status_internal_cache_status_get","parameters":[{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/cache/refresh":{"post":{"summary":"Internal Cache Refresh","operationId":"internal_cache_refresh_internal_cache_refresh_post","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Scope"}},{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/farm-listings/{submission_id}/publish":{"post":{"summary":"Publish Farm Listing","operationId":"publish_farm_listing_farm_listings__submission_id__publish_post","parameters":[{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}},{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/cache/stats":{"get":{"summary":"Admin Snapshot Stats","description":"Local Supabase read-cache health. Pairs with /admin/ops/metrics in the ops panel.","operationId":"admin_snapshot_stats_admin_cache_stats_get","parameters":[{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/cache/refresh":{"post":{"summary":"Admin Snapshot Force Refresh","description":"Force a synchronous snapshot refresh now. Used when an out-of-band\nwrite to Supabase needs to be reflected immediately.","operationId":"admin_snapshot_force_refresh_admin_cache_refresh_post","parameters":[{"name":"X-Admin-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delivery/checkout":{"post":{"summary":"Create Checkout","operationId":"create_checkout_delivery_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delivery/webhook":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_delivery_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/delivery/order/{order_ref}":{"get":{"summary":"Get Order","operationId":"get_order_delivery_order__order_ref__get","parameters":[{"name":"order_ref","in":"path","required":true,"schema":{"type":"string","title":"Order Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stock-alerts/me":{"get":{"summary":"Get My Stock Alert","operationId":"get_my_stock_alert_stock_alerts_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Put My Stock Alert","operationId":"put_my_stock_alert_stock_alerts_me_put","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockAlertUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AlertRequestIn":{"properties":{"email":{"type":"string","maxLength":320,"title":"Email","default":""},"area_label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Area Label","default":""},"query":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Query","default":""},"filters":{"items":{"type":"string"},"type":"array","title":"Filters"},"page_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Page Url","default":""}},"type":"object","title":"AlertRequestIn"},"CheckoutIn":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CheckoutItem"},"type":"array","title":"Items"},"delivery":{"$ref":"#/components/schemas/DeliveryAddress"},"return_url":{"type":"string","title":"Return Url"},"mode":{"type":"string","title":"Mode","default":"test"}},"type":"object","required":["items","delivery","return_url"],"title":"CheckoutIn"},"CheckoutItem":{"properties":{"id":{"type":"string","title":"Id"},"qty":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Qty"}},"type":"object","required":["id","qty"],"title":"CheckoutItem"},"DeliveryAddress":{"properties":{"name":{"type":"string","title":"Name"},"phone":{"type":"string","title":"Phone"},"street":{"type":"string","title":"Street"},"apt":{"type":"string","title":"Apt","default":""},"neighborhood":{"type":"string","title":"Neighborhood"},"zip":{"type":"string","title":"Zip"},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["name","phone","street","neighborhood","zip"],"title":"DeliveryAddress"},"FarmListingIn":{"properties":{"farm_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Farm Name","default":""},"town":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Town","default":""},"year_established":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Year Established","default":""},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tagline","default":""},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","default":""},"practices":{"items":{"type":"string"},"type":"array","title":"Practices","default":[]},"products":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Products","default":""},"fulfillment":{"items":{"type":"string"},"type":"array","title":"Fulfillment","default":[]},"hours":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hours","default":""},"reply_preference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Preference","default":""},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","default":""},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":""},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":""},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","default":""},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","default":""},"hide_exact_address":{"type":"boolean","title":"Hide Exact Address","default":false},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lng":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng"},"claimed_farm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimed Farm Id"},"claimed_farm_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimed Farm Name"},"claimed_farm_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimed Farm State"},"source_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Page"}},"type":"object","title":"FarmListingIn"},"FarmReviewAdminUpdateIn":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"FarmReviewAdminUpdateIn"},"FarmReviewIn":{"properties":{"rating":{"type":"integer","title":"Rating"},"experience_type":{"type":"string","title":"Experience Type"},"experienced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experienced At"},"still_operating":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Still Operating"},"products":{"items":{"type":"string"},"type":"array","title":"Products"},"fulfillment":{"items":{"type":"string"},"type":"array","title":"Fulfillment"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body","default":""},"author_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Display Name","default":""}},"type":"object","required":["rating","experience_type"],"title":"FarmReviewIn"},"FarmReviewReportIn":{"properties":{"reason":{"type":"string","title":"Reason","default":"not_helpful"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","default":""}},"type":"object","title":"FarmReviewReportIn"},"FarmUpdateSuggestionIn":{"properties":{"update":{"type":"string","maxLength":6000,"title":"Update","default":""},"source_page":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Source Page","default":""}},"type":"object","title":"FarmUpdateSuggestionIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InquiryIn":{"properties":{"farm_id":{"type":"string","title":"Farm Id"},"pickup":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pickup"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","default":""},"contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact","default":""},"items":{"items":{"$ref":"#/components/schemas/InquiryItem"},"type":"array","title":"Items","default":[]}},"type":"object","required":["farm_id"],"title":"InquiryIn"},"InquiryItem":{"properties":{"name":{"type":"string","title":"Name"},"qty":{"type":"integer","title":"Qty"}},"type":"object","required":["name","qty"],"title":"InquiryItem"},"LowResultFarmAlertIn":{"properties":{"event":{"type":"string","maxLength":80,"title":"Event","default":""},"area_label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Area Label","default":""},"result_count":{"type":"integer","title":"Result Count","default":0},"query":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Query","default":""},"filters":{"items":{"type":"string"},"type":"array","title":"Filters"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email","default":""},"source_page":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Source Page","default":""}},"type":"object","title":"LowResultFarmAlertIn"},"StockAlertUpdate":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":25,"minItems":1,"title":"Keywords"},"location_label":{"type":"string","maxLength":160,"minLength":1,"title":"Location Label"},"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lng":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lng"},"radius_miles":{"type":"number","maximum":250.0,"minimum":25.0,"title":"Radius Miles"},"enabled":{"type":"boolean","title":"Enabled","default":true},"home_delivery_only":{"type":"boolean","title":"Home Delivery Only","description":"Only include delivery-available farms without a shipping-only signal.","default":false}},"additionalProperties":false,"type":"object","required":["keywords","location_label","lat","lng","radius_miles"],"title":"StockAlertUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}