{"openapi":"3.1.0","info":{"title":"prokit-ghana-api","description":"Fashion marketplace API","version":"0.1.0"},"paths":{"/api/v1/auth/register":{"post":{"tags":["authentication"],"summary":"Register","operationId":"register_api_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login":{"post":{"tags":["authentication"],"summary":"Login","operationId":"login_api_v1_auth_login_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_login_api_v1_auth_login_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["authentication"],"summary":"Me","operationId":"me_api_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"patch":{"tags":["authentication"],"summary":"Update Me","operationId":"update_me_api_v1_auth_me_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/auth/me/avatar":{"post":{"tags":["authentication"],"summary":"Upload My Avatar","operationId":"upload_my_avatar_api_v1_auth_me_avatar_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_my_avatar_api_v1_auth_me_avatar_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"delete":{"tags":["authentication"],"summary":"Remove My Avatar","operationId":"remove_my_avatar_api_v1_auth_me_avatar_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/categories":{"get":{"tags":["catalog"],"summary":"Categories","operationId":"categories_api_v1_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CategoryOut"},"type":"array","title":"Response Categories Api V1 Categories Get"}}}}}}},"/api/v1/products":{"get":{"tags":["catalog"],"summary":"Products","operationId":"products_api_v1_products_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"featured","title":"Sort"}},{"name":"featured","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Featured"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOut"},"title":"Response Products Api V1 Products Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/products/{slug}":{"get":{"tags":["catalog"],"summary":"Product Detail","operationId":"product_detail_api_v1_products__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/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/delivery-fee":{"get":{"tags":["orders"],"summary":"Public Delivery Fee","operationId":"public_delivery_fee_api_v1_orders_delivery_fee_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"Greater Accra","title":"Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders":{"post":{"tags":["orders"],"summary":"Create Order","operationId":"create_order_api_v1_orders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/orders/mine":{"get":{"tags":["orders"],"summary":"My Orders","operationId":"my_orders_api_v1_orders_mine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrderOut"},"type":"array","title":"Response My Orders Api V1 Orders Mine Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/vendor/products/upload-image":{"post":{"tags":["vendor dashboard"],"summary":"Upload Vendor Product Image","operationId":"upload_vendor_product_image_api_v1_vendor_products_upload_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_vendor_product_image_api_v1_vendor_products_upload_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/vendor/products/{product_id}/images":{"put":{"tags":["vendor dashboard"],"summary":"Update Vendor Product Images","operationId":"update_vendor_product_images_api_v1_vendor_products__product_id__images_put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductImagesUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vendor/me":{"get":{"tags":["vendor dashboard"],"summary":"Vendor Me","operationId":"vendor_me_api_v1_vendor_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/vendor/summary":{"get":{"tags":["vendor dashboard"],"summary":"Vendor Summary","operationId":"vendor_summary_api_v1_vendor_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/vendor/products":{"get":{"tags":["vendor dashboard"],"summary":"List Vendor Products","operationId":"list_vendor_products_api_v1_vendor_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProductOut"},"type":"array","title":"Response List Vendor Products Api V1 Vendor Products Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"tags":["vendor dashboard"],"summary":"Create Vendor Product","operationId":"create_vendor_product_api_v1_vendor_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorProductCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/vendor/products/{product_id}":{"patch":{"tags":["vendor dashboard"],"summary":"Update Vendor Product","operationId":"update_vendor_product_api_v1_vendor_products__product_id__patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductManageUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["vendor dashboard"],"summary":"Delete Vendor Product","operationId":"delete_vendor_product_api_v1_vendor_products__product_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/vendor/products/{product_id}/inventory":{"patch":{"tags":["vendor dashboard"],"summary":"Set Vendor Inventory","operationId":"set_vendor_inventory_api_v1_vendor_products__product_id__inventory_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventorySet"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/settings/delivery-fee":{"get":{"tags":["admin dashboard"],"summary":"Get Delivery Fee","operationId":"get_delivery_fee_api_v1_admin_settings_delivery_fee_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"put":{"tags":["admin dashboard"],"summary":"Update Delivery Fee","operationId":"update_delivery_fee_api_v1_admin_settings_delivery_fee_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryFeeUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/settings/delivery-fees":{"get":{"tags":["admin dashboard"],"summary":"Get Delivery Fees","operationId":"get_delivery_fees_api_v1_admin_settings_delivery_fees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"put":{"tags":["admin dashboard"],"summary":"Update Delivery Fees","operationId":"update_delivery_fees_api_v1_admin_settings_delivery_fees_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryFeesUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/products/upload-image":{"post":{"tags":["admin dashboard"],"summary":"Upload Admin Product Image","operationId":"upload_admin_product_image_api_v1_admin_products_upload_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_admin_product_image_api_v1_admin_products_upload_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/summary":{"get":{"tags":["admin dashboard"],"summary":"Summary","operationId":"summary_api_v1_admin_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/orders":{"get":{"tags":["admin dashboard"],"summary":"List Orders","operationId":"list_orders_api_v1_admin_orders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrderOut"},"type":"array","title":"Response List Orders Api V1 Admin Orders Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/orders/{order_id}/status":{"patch":{"tags":["admin dashboard"],"summary":"Update Order Status","operationId":"update_order_status_api_v1_admin_orders__order_id__status_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"integer","title":"Order Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/products":{"get":{"tags":["admin dashboard"],"summary":"List Products","operationId":"list_products_api_v1_admin_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProductOut"},"type":"array","title":"Response List Products Api V1 Admin Products Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/products/{product_id}/status":{"patch":{"tags":["admin dashboard"],"summary":"Update Product Status","operationId":"update_product_status_api_v1_admin_products__product_id__status_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users":{"get":{"tags":["admin dashboard"],"summary":"List Users","operationId":"list_users_api_v1_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UserOut"},"type":"array","title":"Response List Users Api V1 Admin Users Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/users/{user_id}/role":{"patch":{"tags":["admin dashboard"],"summary":"Update User Role","operationId":"update_user_role_api_v1_admin_users__user_id__role_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserRoleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/status":{"patch":{"tags":["admin dashboard"],"summary":"Update User Status","operationId":"update_user_status_api_v1_admin_users__user_id__status_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/vendors":{"get":{"tags":["admin dashboard"],"summary":"List Vendors","operationId":"list_vendors_api_v1_admin_vendors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"tags":["admin dashboard"],"summary":"Create Vendor","operationId":"create_vendor_api_v1_admin_vendors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/vendors/{vendor_id}/approval":{"patch":{"tags":["admin dashboard"],"summary":"Set Vendor Approval","operationId":"set_vendor_approval_api_v1_admin_vendors__vendor_id__approval_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vendor_id","in":"path","required":true,"schema":{"type":"integer","title":"Vendor Id"}},{"name":"approved","in":"query","required":true,"schema":{"type":"boolean","title":"Approved"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/categories":{"post":{"tags":["admin dashboard"],"summary":"Create Category","operationId":"create_category_api_v1_admin_categories_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/admin/categories/{category_id}":{"put":{"tags":["admin dashboard"],"summary":"Update Category","operationId":"update_category_api_v1_admin_categories__category_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin dashboard"],"summary":"Delete Category","operationId":"delete_category_api_v1_admin_categories__category_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/products/{product_id}":{"patch":{"tags":["admin dashboard"],"summary":"Update Product","operationId":"update_product_api_v1_admin_products__product_id__patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductManageUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin dashboard"],"summary":"Delete Admin Product","operationId":"delete_admin_product_api_v1_admin_products__product_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/products/{product_id}/images":{"put":{"tags":["admin dashboard"],"summary":"Update Admin Product Images","operationId":"update_admin_product_images_api_v1_admin_products__product_id__images_put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductImagesUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/products/{product_id}/inventory":{"patch":{"tags":["admin dashboard"],"summary":"Set Product Inventory","operationId":"set_product_inventory_api_v1_admin_products__product_id__inventory_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventorySet"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/inventory/low-stock":{"get":{"tags":["admin dashboard"],"summary":"Low Stock Products","operationId":"low_stock_products_api_v1_admin_inventory_low_stock_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"threshold","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Threshold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOut"},"title":"Response Low Stock Products Api V1 Admin Inventory Low Stock Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/payments/manual-methods":{"get":{"tags":["payments"],"summary":"Public Manual Payment Methods","operationId":"public_manual_payment_methods_api_v1_payments_manual_methods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/payments/manual/submit":{"post":{"tags":["payments"],"summary":"Submit Manual Payment","operationId":"submit_manual_payment_api_v1_payments_manual_submit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualPaymentSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/payments/manual-pending":{"get":{"tags":["payments"],"summary":"List Pending Manual Payments","operationId":"list_pending_manual_payments_api_v1_payments_manual_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/payments/manual/{payment_id}/confirm":{"post":{"tags":["payments"],"summary":"Confirm Manual Payment","operationId":"confirm_manual_payment_api_v1_payments_manual__payment_id__confirm_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"integer","title":"Payment Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualPaymentConfirmation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/payments/manual-settings":{"get":{"tags":["payments"],"summary":"Get Manual Payment Settings","operationId":"get_manual_payment_settings_api_v1_payments_manual_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"put":{"tags":["payments"],"summary":"Update Manual Payment Settings","operationId":"update_manual_payment_settings_api_v1_payments_manual_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualPaymentSettings"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/payments/initialize":{"post":{"tags":["payments"],"summary":"Payment Initialize","operationId":"payment_initialize_api_v1_payments_initialize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentInitialize"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/payments/webhooks/{provider}":{"post":{"tags":["payments"],"summary":"Payment Webhook","operationId":"payment_webhook_api_v1_payments_webhooks__provider__post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/cart":{"get":{"tags":["customer cart"],"summary":"Get Cart","operationId":"get_cart_api_v1_cart_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartOut"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"put":{"tags":["customer cart"],"summary":"Replace Cart","operationId":"replace_cart_api_v1_cart_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartReplace"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/":{"get":{"tags":["system"],"summary":"Landing Page","operationId":"landing_page__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["system"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"Body_login_api_v1_auth_login_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_login_api_v1_auth_login_post"},"Body_upload_admin_product_image_api_v1_admin_products_upload_image_post":{"properties":{"image":{"type":"string","format":"binary","title":"Image"}},"type":"object","required":["image"],"title":"Body_upload_admin_product_image_api_v1_admin_products_upload_image_post"},"Body_upload_my_avatar_api_v1_auth_me_avatar_post":{"properties":{"image":{"type":"string","format":"binary","title":"Image"}},"type":"object","required":["image"],"title":"Body_upload_my_avatar_api_v1_auth_me_avatar_post"},"Body_upload_vendor_product_image_api_v1_vendor_products_upload_image_post":{"properties":{"image":{"type":"string","format":"binary","title":"Image"}},"type":"object","required":["image"],"title":"Body_upload_vendor_product_image_api_v1_vendor_products_upload_image_post"},"CartItemIn":{"properties":{"product_id":{"type":"integer","title":"Product Id"},"quantity":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Quantity"},"size":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Size"},"color":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Color"},"customization_text":{"anyOf":[{"type":"string","maxLength":24,"minLength":1},{"type":"null"}],"title":"Customization Text"}},"type":"object","required":["product_id","quantity"],"title":"CartItemIn"},"CartItemOut":{"properties":{"product":{"$ref":"#/components/schemas/ProductOut"},"quantity":{"type":"integer","title":"Quantity"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"customization_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customization Text"}},"type":"object","required":["product","quantity"],"title":"CartItemOut"},"CartOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CartItemOut"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"CartOut"},"CartReplace":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CartItemIn"},"type":"array","maxItems":50,"title":"Items"}},"type":"object","title":"CartReplace"},"CategoryCreate":{"properties":{"name":{"type":"string","maxLength":100,"minLength":2,"title":"Name"},"slug":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"}},"type":"object","required":["name","slug"],"title":"CategoryCreate"},"CategoryOut":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"}},"type":"object","required":["id","name","slug"],"title":"CategoryOut"},"DeliveryFeeUpdate":{"properties":{"delivery_fee_ghs":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Delivery Fee Ghs"}},"type":"object","required":["delivery_fee_ghs"],"title":"DeliveryFeeUpdate"},"DeliveryFeesUpdate":{"properties":{"delivery_fee_ghs":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Delivery Fee Ghs"},"outside_accra_delivery_fee_ghs":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Outside Accra Delivery Fee Ghs"}},"type":"object","required":["delivery_fee_ghs","outside_accra_delivery_fee_ghs"],"title":"DeliveryFeesUpdate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InventorySet":{"properties":{"stock_quantity":{"type":"integer","minimum":0.0,"title":"Stock Quantity"},"reason":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Reason"}},"type":"object","required":["stock_quantity"],"title":"InventorySet"},"ManualMomoAccount":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"account_name":{"type":"string","title":"Account Name","default":""},"number":{"type":"string","title":"Number","default":""},"instructions":{"type":"string","title":"Instructions","default":""}},"type":"object","title":"ManualMomoAccount"},"ManualPaymentConfirmation":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"type":"object","title":"ManualPaymentConfirmation"},"ManualPaymentSettings":{"properties":{"momo_enabled":{"type":"boolean","title":"Momo Enabled","default":true},"momo_networks":{"items":{"type":"string"},"type":"array","title":"Momo Networks"},"momo_accounts":{"additionalProperties":{"$ref":"#/components/schemas/ManualMomoAccount"},"type":"object","title":"Momo Accounts"},"momo_account_name":{"type":"string","title":"Momo Account Name","default":""},"momo_number":{"type":"string","title":"Momo Number","default":""},"momo_instructions":{"type":"string","title":"Momo Instructions","default":""},"bank_enabled":{"type":"boolean","title":"Bank Enabled","default":true},"bank_name":{"type":"string","title":"Bank Name","default":""},"bank_account_name":{"type":"string","title":"Bank Account Name","default":""},"bank_account_number":{"type":"string","title":"Bank Account Number","default":""},"bank_branch":{"type":"string","title":"Bank Branch","default":""},"bank_instructions":{"type":"string","title":"Bank Instructions","default":""}},"type":"object","title":"ManualPaymentSettings"},"ManualPaymentSubmission":{"properties":{"order_id":{"type":"integer","title":"Order Id"},"method":{"type":"string","pattern":"^(manual_momo|manual_bank)$","title":"Method"},"network":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Network"},"transaction_reference":{"type":"string","maxLength":120,"minLength":3,"title":"Transaction Reference"}},"type":"object","required":["order_id","method","transaction_reference"],"title":"ManualPaymentSubmission"},"OrderCreate":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrderItemIn"},"type":"array","maxItems":50,"minItems":1,"title":"Items"},"recipient_name":{"type":"string","maxLength":160,"minLength":2,"title":"Recipient Name"},"phone":{"type":"string","maxLength":40,"minLength":7,"title":"Phone"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address"},"city":{"type":"string","maxLength":100,"minLength":2,"title":"City"},"region":{"type":"string","maxLength":100,"minLength":2,"title":"Region"},"delivery_method":{"type":"string","pattern":"^(delivery|self_pickup|dispatch)$","title":"Delivery Method"},"payment_method":{"type":"string","pattern":"^(cash_on_delivery|manual_momo|manual_bank)$","title":"Payment Method"},"payment_network":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Payment Network"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"string"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"string"},{"type":"null"}],"title":"Longitude"},"maps_link":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Maps Link"},"notes":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["items","recipient_name","phone","city","region","delivery_method","payment_method"],"title":"OrderCreate"},"OrderItemIn":{"properties":{"product_id":{"type":"integer","title":"Product Id"},"quantity":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Quantity"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"customization_text":{"anyOf":[{"type":"string","maxLength":24,"minLength":1},{"type":"null"}],"title":"Customization Text"}},"type":"object","required":["product_id","quantity"],"title":"OrderItemIn"},"OrderOut":{"properties":{"id":{"type":"integer","title":"Id"},"order_number":{"type":"string","title":"Order Number"},"status":{"type":"string","title":"Status"},"payment_status":{"type":"string","title":"Payment Status"},"payment_method":{"type":"string","title":"Payment Method","default":"manual_momo"},"subtotal":{"type":"string","title":"Subtotal"},"delivery_fee":{"type":"string","title":"Delivery Fee"},"total":{"type":"string","title":"Total"},"currency":{"type":"string","title":"Currency"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","order_number","status","payment_status","subtotal","delivery_fee","total","currency","created_at"],"title":"OrderOut"},"OrderStatusUpdate":{"properties":{"status":{"type":"string","pattern":"^(processing|packed|shipped|delivered|cancelled)$","title":"Status"}},"type":"object","required":["status"],"title":"OrderStatusUpdate"},"PaymentInitialize":{"properties":{"order_id":{"type":"integer","title":"Order Id"},"provider":{"type":"string","pattern":"^(paystack|hubtel)$","title":"Provider"},"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["order_id","provider","email"],"title":"PaymentInitialize"},"ProductImageOut":{"properties":{"id":{"type":"integer","title":"Id"},"url":{"type":"string","title":"Url"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"sort_order":{"type":"integer","title":"Sort Order","default":0}},"type":"object","required":["id","url","alt_text"],"title":"ProductImageOut"},"ProductImagesUpdate":{"properties":{"image_urls":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Image Urls"}},"type":"object","required":["image_urls"],"title":"ProductImagesUpdate"},"ProductManageUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":180,"minLength":2},{"type":"null"}],"title":"Name"},"slug":{"anyOf":[{"type":"string","maxLength":200,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},{"type":"null"}],"title":"Slug"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"price":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"string"},{"type":"null"}],"title":"Price"},"category_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Category Id"},"stock_quantity":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Stock Quantity"},"sizes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sizes"},"colors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colors"},"image_url":{"anyOf":[{"type":"string","maxLength":1000,"minLength":8},{"type":"null"}],"title":"Image Url"},"customization_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Customization Enabled"},"customization_price":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Customization Price"}},"type":"object","title":"ProductManageUpdate"},"ProductOut":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"type":"string","title":"Description"},"price":{"type":"string","title":"Price"},"compare_at_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compare At Price"},"currency":{"type":"string","title":"Currency"},"stock_quantity":{"type":"integer","title":"Stock Quantity"},"sizes":{"items":{"type":"string"},"type":"array","title":"Sizes"},"colors":{"items":{"type":"string"},"type":"array","title":"Colors"},"is_featured":{"type":"boolean","title":"Is Featured"},"customization_enabled":{"type":"boolean","title":"Customization Enabled","default":false},"customization_price":{"type":"string","title":"Customization Price","default":"0.00"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryOut"},{"type":"null"}]},"images":{"items":{"$ref":"#/components/schemas/ProductImageOut"},"type":"array","title":"Images"}},"type":"object","required":["id","name","slug","description","price","compare_at_price","currency","stock_quantity","sizes","colors","is_featured"],"title":"ProductOut"},"ProductStatusUpdate":{"properties":{"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["is_active"],"title":"ProductStatusUpdate"},"TokenOut":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"user":{"$ref":"#/components/schemas/UserOut"}},"type":"object","required":["access_token","user"],"title":"TokenOut"},"UserCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"full_name":{"type":"string","maxLength":160,"minLength":2,"title":"Full Name"},"password":{"type":"string","maxLength":128,"minLength":8,"title":"Password"}},"type":"object","required":["email","full_name","password"],"title":"UserCreate"},"UserOut":{"properties":{"id":{"type":"integer","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"full_name":{"type":"string","title":"Full Name"},"role":{"type":"string","title":"Role"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["id","email","full_name","role"],"title":"UserOut"},"UserProfileUpdate":{"properties":{"full_name":{"type":"string","maxLength":160,"minLength":2,"title":"Full Name"},"email":{"type":"string","format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Phone"}},"type":"object","required":["full_name","email"],"title":"UserProfileUpdate"},"UserRoleUpdate":{"properties":{"role":{"type":"string","pattern":"^(customer|vendor)$","title":"Role"}},"type":"object","required":["role"],"title":"UserRoleUpdate"},"UserStatusUpdate":{"properties":{"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["is_active"],"title":"UserStatusUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VendorCreate":{"properties":{"user_id":{"type":"integer","title":"User Id"},"store_name":{"type":"string","maxLength":160,"minLength":2,"title":"Store Name"},"slug":{"type":"string","maxLength":180,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"}},"type":"object","required":["user_id","store_name","slug"],"title":"VendorCreate"},"VendorProductCreate":{"properties":{"name":{"type":"string","maxLength":180,"minLength":2,"title":"Name"},"slug":{"type":"string","maxLength":200,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"description":{"type":"string","title":"Description","default":""},"price":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"string"}],"title":"Price"},"category_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Category Id"},"stock_quantity":{"type":"integer","minimum":0.0,"title":"Stock Quantity"},"sizes":{"items":{"type":"string"},"type":"array","title":"Sizes","default":[]},"colors":{"items":{"type":"string"},"type":"array","title":"Colors","default":[]},"image_url":{"type":"string","maxLength":1000,"minLength":8,"title":"Image Url"},"customization_enabled":{"type":"boolean","title":"Customization Enabled","default":false},"customization_price":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Customization Price","default":"0.00"}},"type":"object","required":["name","slug","price","stock_quantity","image_url"],"title":"VendorProductCreate"}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/auth/login"}}}}}}