{"openapi":"3.1.0","info":{"title":"Hackathon Merchant API","description":"Backend API for WhatsApp-based merchant commerce hackathon","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["meta"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Service dependency unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/merchants":{"get":{"tags":["merchants"],"summary":"List Merchants","operationId":"list_merchants_merchants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MerchantListItem"},"type":"array","title":"Response List Merchants Merchants Get"}}}}}}},"/merchants/{slug}":{"get":{"tags":["merchants"],"summary":"Get Merchant","operationId":"get_merchant_merchants__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantDetail"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/merchants/{slug}/items":{"get":{"tags":["merchants"],"summary":"List Merchant Items","operationId":"list_merchant_items_merchants__slug__items_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ItemResponse"},"title":"Response List Merchant Items Merchants  Slug  Items Get"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/merchants/{slug}/campaigns":{"get":{"tags":["merchants"],"summary":"List Merchant Campaigns","operationId":"list_merchant_campaigns_merchants__slug__campaigns_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"team_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CampaignSummary"},"title":"Response List Merchant Campaigns Merchants  Slug  Campaigns Get"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/items/{item_id}":{"get":{"tags":["items"],"summary":"Get Item","operationId":"get_item_items__item_id__get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/baskets":{"post":{"tags":["baskets"],"summary":"Create Basket","operationId":"create_basket_baskets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasketCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasketCreateResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation failed or business rule violation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/baskets/{basket_id}":{"get":{"tags":["baskets"],"summary":"Get Basket","operationId":"get_basket_baskets__basket_id__get","parameters":[{"name":"basket_id","in":"path","required":true,"schema":{"type":"string","title":"Basket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasketDetail"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/campaigns":{"post":{"tags":["campaigns"],"summary":"Create Campaign","operationId":"create_campaign_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignCreateResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation failed or business rule violation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/campaigns/{campaign_id}":{"get":{"tags":["campaigns"],"summary":"Get Campaign","operationId":"get_campaign_campaigns__campaign_id__get","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDetail"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams":{"get":{"tags":["teams"],"summary":"List Teams","operationId":"list_teams_teams_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/TeamSummary"},"type":"array","title":"Response List Teams Teams Get"}}}}}},"post":{"tags":["teams"],"summary":"Create Team","operationId":"create_team_teams_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamCreateResponse"}}}},"409":{"description":"Resource already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation failed or business rule violation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/teams/{slug}":{"get":{"tags":["teams"],"summary":"Get Team","operationId":"get_team_teams__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/uploads":{"post":{"tags":["uploads"],"summary":"Upload File","operationId":"upload_file_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_uploads_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"413":{"description":"File exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation failed or business rule violation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/uploads/rehost":{"post":{"tags":["uploads"],"summary":"Rehost Image","operationId":"rehost_image_uploads_rehost_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RehostRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"413":{"description":"File exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation failed or business rule violation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"BasketCreateRequest":{"properties":{"merchant_id":{"type":"string","title":"Merchant Id"},"items":{"items":{"$ref":"#/components/schemas/BasketItemInput"},"type":"array","minItems":1,"title":"Items"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"customer_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Phone"},"customer_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Note"},"team_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"}},"type":"object","required":["merchant_id","items"],"title":"BasketCreateRequest"},"BasketCreateResponse":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"BasketCreateResponse"},"BasketDetail":{"properties":{"id":{"type":"string","title":"Id"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/BasketMerchant"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/BasketItem"},"type":"array","title":"Items"},"total_minor":{"type":"integer","title":"Total Minor"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"customer_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Phone"},"customer_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Note"},"team_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","items","total_minor","created_at"],"title":"BasketDetail"},"BasketItem":{"properties":{"item_id":{"type":"string","title":"Item Id"},"name":{"type":"string","title":"Name"},"price_minor":{"type":"integer","title":"Price Minor"},"currency":{"type":"string","title":"Currency"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"in_stock":{"type":"boolean","title":"In Stock"},"qty":{"type":"integer","title":"Qty"},"item_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Note"}},"type":"object","required":["item_id","name","price_minor","currency","in_stock","qty"],"title":"BasketItem"},"BasketItemInput":{"properties":{"item_id":{"type":"string","title":"Item Id"},"qty":{"type":"integer","minimum":1.0,"title":"Qty"},"item_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Note"}},"type":"object","required":["item_id","qty"],"title":"BasketItemInput"},"BasketMerchant":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"whatsapp_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whatsapp Number"}},"type":"object","required":["id","name"],"title":"BasketMerchant"},"Body_upload_file_uploads_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_uploads_post"},"CampaignCreateRequest":{"properties":{"merchant_id":{"type":"string","title":"Merchant Id"},"title":{"type":"string","title":"Title"},"copy_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Copy Text"},"image_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Image Urls"},"featured_item_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Featured Item Ids"},"team_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"}},"type":"object","required":["merchant_id","title"],"title":"CampaignCreateRequest"},"CampaignCreateResponse":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"CampaignCreateResponse"},"CampaignDetail":{"properties":{"id":{"type":"string","title":"Id"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/BasketMerchant"},{"type":"null"}]},"title":{"type":"string","title":"Title"},"copy_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Copy Text"},"image_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Image Urls"},"featured_items":{"items":{"$ref":"#/components/schemas/CampaignFeaturedItem"},"type":"array","title":"Featured Items"},"team_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","title","featured_items","created_at"],"title":"CampaignDetail"},"CampaignFeaturedItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"price_minor":{"type":"integer","title":"Price Minor"},"currency":{"type":"string","title":"Currency"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"in_stock":{"type":"boolean","title":"In Stock"}},"type":"object","required":["id","name","price_minor","currency","in_stock"],"title":"CampaignFeaturedItem"},"CampaignSummary":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"copy_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Copy Text"},"image_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Image Urls"},"team_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Slug"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","title","created_at"],"title":"CampaignSummary"},"ErrorResponse":{"properties":{"error":{"type":"string","title":"Error"},"message":{"type":"string","title":"Message"}},"type":"object","required":["error","message"],"title":"ErrorResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"db":{"type":"string","title":"Db"},"uploads":{"type":"string","title":"Uploads"},"assets":{"type":"string","title":"Assets"}},"type":"object","required":["status","db","uploads","assets"],"title":"HealthResponse"},"ItemResponse":{"properties":{"id":{"type":"string","title":"Id"},"merchant_id":{"type":"string","title":"Merchant Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"price_minor":{"type":"integer","title":"Price Minor"},"currency":{"type":"string","title":"Currency"},"image_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Image Urls"},"in_stock":{"type":"boolean","title":"In Stock"}},"type":"object","required":["id","merchant_id","name","price_minor","currency","in_stock"],"title":"ItemResponse"},"MerchantDetail":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"brand_colors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Brand Colors"},"whatsapp_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whatsapp Number"}},"type":"object","required":["id","name"],"title":"MerchantDetail"},"MerchantListItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"whatsapp_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whatsapp Number"}},"type":"object","required":["id","name"],"title":"MerchantListItem"},"RehostRequest":{"properties":{"source_url":{"type":"string","title":"Source Url"}},"type":"object","required":["source_url"],"title":"RehostRequest"},"TeamBasketRef":{"properties":{"id":{"type":"string","title":"Id"},"merchant_id":{"type":"string","title":"Merchant Id"},"total_minor":{"type":"integer","title":"Total Minor"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","merchant_id","total_minor","created_at"],"title":"TeamBasketRef"},"TeamCampaignRef":{"properties":{"id":{"type":"string","title":"Id"},"merchant_id":{"type":"string","title":"Merchant Id"},"title":{"type":"string","title":"Title"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","merchant_id","title","created_at"],"title":"TeamCampaignRef"},"TeamCreateRequest":{"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{2,40}$","title":"Slug","description":"2-40 chars of lowercase letters, digits, or hyphens."},"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"merchant_id":{"type":"string","title":"Merchant Id","description":"The merchant this team is building for. Must match a slug from /merchants."},"contact":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Contact"}},"type":"object","required":["slug","name","merchant_id"],"title":"TeamCreateRequest"},"TeamCreateResponse":{"properties":{"slug":{"type":"string","title":"Slug"}},"type":"object","required":["slug"],"title":"TeamCreateResponse"},"TeamDetail":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/BasketMerchant"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact"},"registered":{"type":"boolean","title":"Registered"},"baskets":{"items":{"$ref":"#/components/schemas/TeamBasketRef"},"type":"array","title":"Baskets"},"campaigns":{"items":{"$ref":"#/components/schemas/TeamCampaignRef"},"type":"array","title":"Campaigns"},"created_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["slug","registered","baskets","campaigns"],"title":"TeamDetail"},"TeamSummary":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"merchant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant Id"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["slug","name","created_at"],"title":"TeamSummary"},"UploadResponse":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"UploadResponse"},"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"}}}}