Kipinä platform API
Accounts, adaptive learning plans, exercises, story authoring, localized content, XP progression, reviewed translations, and vocabulary — one authenticated interface.
OpenAPI 3.1 JSONAuthentication
Send a browser session token or scoped API key as Authorization: Bearer <token>. Create keys from the account screen or POST /api/v1/me/api-keys.
Core surfaces
GET /api/v1/learning/planAdaptive daily planDaily XP progress, mastery, due reviews, and ranked recommendations.
GET /api/v1/exercisesAdaptive exercisesDeterministic cloze, word-order, and listening practice with private answers.
GET /api/v1/storiesLearning libraryPublished localized stories and private progress; source previews remain editor/owner-only.
POST /api/v1/tooltips/purchaseXP magic-wand tooltipsPurchase elements, words, ranges, and discounted paragraphs; overlapping paid ranges merge.
POST /api/v1/admin/storiesStory studioCreate stories with nested segments, choices, translations, and glossary.
MCP pausedMCP disabledRemote and local MCP connections are temporarily unavailable.
Language model
Every story is authored first in English. Learners receive a reviewed target-language version; canonical English and drafts are reserved for editor/owner previews. The seeded account pair is Finnish for learning and English for magic-wand tooltips.