{"openapi":"3.0.3","info":{"title":"CreatoCloud API","version":"1.0.0","description":"Multi-tenant REST API for products, orders, inventory, customers, and integrations. Authenticate with a session cookie (seller dashboard) or Bearer API token.","contact":{"name":"CreatoCloud Developers","url":"https://www.creatocloud.com/developers"}},"servers":[{"url":"https://www.creatocloud.com/api/v1","description":"Current environment"}],"paths":{"/products":{"get":{"operationId":"list-products","summary":"List products","description":"Returns products for the authenticated business (demo business when unsigned in playground).","security":[{"bearerAuth":[]},{"cookieAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[{"id":"prod_demo_serum","name":"Hydra Glow Serum","sku":"GLB-SERUM-01","price":38,"inventoryQuantity":84,"status":"active"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"example":{"error":"Unauthorized"}}}}}}},"/orders":{"get":{"operationId":"list-orders","summary":"List orders","description":"Lists orders with payment and fulfillment status for the current business.","security":[{"bearerAuth":[]},{"cookieAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[{"id":"ord_demo","orderNumber":"GT-10046","total":90.08,"paymentStatus":"paid","fulfillmentStatus":"unfulfilled","createdAt":"2026-07-30T12:00:00.000Z"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"example":{"error":"Unauthorized"}}}}}}},"/inventory":{"get":{"operationId":"list-inventory","summary":"List inventory","description":"On-hand, reserved, and location inventory rows for warehouse ops.","security":[{"bearerAuth":[]},{"cookieAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[{"sku":"GLB-SERUM-01","available":84,"reserved":6,"location":"Atlanta Hub — Dunwoody"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"example":{"error":"Unauthorized"}}}}}}},"/customers":{"get":{"operationId":"list-customers","summary":"List customers","description":"Customers associated with CreatoCloud orders for the business.","security":[{"bearerAuth":[]},{"cookieAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[{"id":"cus_demo","name":"Jordan Lee","email":"jordan@example.com","orderCount":2}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"example":{"error":"Unauthorized"}}}}}}},"/integrations":{"get":{"operationId":"list-integrations","summary":"List integration catalog","description":"Public catalog of CreatoCloud integrations (marketplaces, shipping, payments, and more).","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[{"slug":"shopify","name":"Shopify","category":"marketplace","status":"available"}]}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key / JWT bearer token (coming soon for external apps)."},"cookieAuth":{"type":"apiKey","in":"cookie","name":"authjs.session-token","description":"Seller session from CreatoCloud login."}}}}