Public API
Connect your tools to SpoolyTracker
The public API lets third-party apps read inventory, push consumption logs, and fetch analytics with scoped organization tokens.
Public documentation
The public Swagger only contains endpoints exposed to external integrations.
Open public Swagger/public-api/v1/filaments List spools
/public-api/v1/filaments/:id Read one spool
/public-api/v1/filaments/:id/stock Update stock
/public-api/v1/consumption Read consumption logs
/public-api/v1/consumption Create a consumption log
/public-api/v1/analytics/stock Stock analytics
/public-api/v1/analytics/consumption Consumption analytics
curl https://api.spoolytracker.com/public-api/v1/filaments \
-H "Authorization: Bearer sk_zsp_xxx"AI Engine
The self-calibrating AI engine, documented end to end
SpoolyTracker ships a self-calibrating, push-only analysis engine: the app pushes workshop state, the engine answers with depletion forecasts, risks, learning reports and chat. It is LLM-free by default, keeps every workshop separate, and can run entirely on your infrastructure when self-hosted.
AI engine Swagger
Every route is documented: the v1 snapshot contract, forecasts, learning, observability and administration.
Open AI Swagger/v1/workspaces/:id/snapshot Replace the full workshop state
/v1/workspaces/:id/events Push idempotent event batches
/v1/workspaces/:id/forecast/stock Per-spool depletion forecasts
/v1/workspaces/:id/risks Per-material risks
/v1/workspaces/:id/learning Learning report (walk-forward verdict, guardrails)
/v1/workspaces/:id/chat AI chat over the workshop state
curl https://ia.spoolytracker.com/v1/workspaces/my-workshop/forecast/stock \
-H "Authorization: Bearer aie_xxx"