AI Trainer API
KinesteX's conversational AI trainer can generate personalized workouts, review workout progression, and provide tailored recommendations — all through natural conversation. Beyond the plug-and-play AI Trainer Chat view, the same intelligence is available as a REST API so you can build your own experience on top of it.
Three integration paths:
| Path | What it is | Best for |
| Plug-and-Play SDK | Fully white-labeled chat UI embedded via the client SDK | Ship fast — configure, skin, and launch with no backend work |
| Trainer Chat API | REST endpoint that handles session management and workout creation through our agentic pipeline | Custom chat UIs — you own the UX, we handle the intelligence |
| Semantic Exercise Search | Vector-indexed exercise search API | Teams building their own AI agents on top of the exercise library |
Base URL: https://data.kinestex.com
All trainer endpoints authenticate end-users with a JWT Bearer token — see Authentication. To get API access, contact KinesteX.
Authentication
Trainer and search endpoints require a JWT Bearer token for a company user (an end-user of your app):
Trainer Chat Endpoint
The unified conversational endpoint. Your users talk to the trainer in natural language — *"give me a 30-minute dumbbell chest workout"*, *"make it harder"*, *"let's start"* — and the API classifies each message's intent, generates or modifies a workout plan, answers fitness questions, and manages the user's fitness profile.
Sessions, Profile & Limits
Chat sessions are persistent, named, durable records — messages survive restarts and can be reloaded any time. A session belongs to the authenticated user; other users cannot read, modify, or delete it.
Semantic Exercise Search
Semantic (vector) search over the exercises accessible to your company. Unlike keyword search, it understands the *meaning* of your query — searching for `"exercises for bad knees"` returns relevant low-impact exercises even if they don't contain those exact words.
Workout Sessions API
Every completed workout session is stored server-side, tied to the `userId` the SDK was initialized with (sessions are persisted when the workout is launched with `shouldSendStats: true`). Fetch the history to build progress screens, completed-workout lists, or analytics.
Session Auth & Managed Subscriptions
Let users browse KinesteX views and chat with the AI trainer for free, while workout generation requires an active subscription that your backend controls. KinesteX stores each user's subscription status and enforces it server-side — the client app can't bypass it.