Home

Magni API Wiki

Welcome to the Magni server API documentation. This wiki covers everything needed to build clients against the Magni backend — including the mobile app.

Contents

• Authentication — JWT login, setup, token usage
• Workouts — Create, log, and finish workouts
• Workout Sets — Add and update sets within a workout
• Templates — Workout templates and exercise management
• Exercises — Exercise library
• Stats & Activity — Daily stats and activity data
• Admin — User management, backups, API keys
• Data Models — Full schema reference
• Mobile App Guide — How to connect a mobile client

Base URL

All endpoints are prefixed with /api. The server always runs HTTPS.

https://YOUR_SERVER_IP:8443/api

Authentication

All endpoints except /api/auth/setup, /api/auth/login, and /api/auth/setup-required require a JWT bearer token:

Authorization: Bearer <token>

Tokens do not expire by default. Store them securely on the client (iOS Keychain, Android Keystore).

Response format

All responses are JSON. Errors follow:

{ "detail": "Error message here" }

HTTP status codes are standard — 200/201 success, 400 bad request, 401 unauthorized, 403 forbidden, 404 not found, 422 validation error.