For Agents
Manage users, courses, enrolments, groups, learning paths, and exam results on LearnUpon LMS — including multi-portal accounts and gamification badges and leaderboards.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the LearnUpon LMS API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with LearnUpon LMS API.
Create, update, and delete user records to keep LearnUpon in sync with the source HRIS
List courses and inspect a single course's full detail including modules and metadata
Enrol and unenrol learners on a course or learning path with a single API call
GET STARTED
Use for: Enrol a user in a specific LearnUpon course, List all available courses on a portal, Get exam results for a specific exam, Add a user to a group
Not supported: Does not handle video hosting, content authoring, or payments — use for user, course, enrolment, path, and exam-results management on LearnUpon only.
Jentic publishes the only available OpenAPI specification for LearnUpon LMS API, keeping it validated and agent-ready. The LearnUpon API exposes a cloud Learning Management System: agents can manage users, list and inspect courses, enrol and unenrol learners, organise people into groups, drive learning paths with their own enrolments, read exam results, and read leaderboard and badge data. Multi-tenant deployments are addressed via a portal subdomain in the base URL, and a /portals endpoint lists the portals the calling account can reach.
Manage groups and group membership to control content visibility for cohorts
Read exam results and leaderboard data to surface progress in external dashboards
List portals on a multi-portal account so an agent can route writes to the right tenant
Patterns agents use LearnUpon LMS API for, with concrete tasks.
★ HRIS-Driven Enrolment Automation
Enrol new hires into mandatory training the day they start. The agent receives a new-hire event from the HRIS, creates the user via POST /users if they do not already exist, then calls POST /enrollments with the courseId and userId. Replaces the manual L&D ticket queue and ensures compliance training assignment is consistent.
On HRIS new-hire event, POST /users with the new hire details, then POST /enrollments with courseId for each mandatory course.
Learning Path Cohort Launch
Kick off a learning path for a group of learners at once. The agent reads the cohort from /groups/{groupId}/members, then iterates POST /learning_paths/{learningPathId}/enrollments per learner so they all start the same day. Useful when a leadership programme runs in defined cohorts and onboarding has to be synchronous.
Call GET /groups/{groupId}/members and POST /learning_paths/{learningPathId}/enrollments once per returned userId.
Exam Results Dashboard Sync
Show exam results in a managers' BI dashboard. The agent reads /exams/{examId}/results on a schedule, joins the userId to the local employee record, and writes pass and fail counts plus average score to the warehouse. Removes the need for managers to log into LearnUpon to inspect compliance scores.
GET /exams/{examId}/results for each tracked exam and load the rows into the warehouse exam_results table keyed by userId.
Gamification Leaderboard Slack Post
Post a weekly leaderboard digest to keep learners engaged. The agent calls /gamification/leaderboard and /gamification/badges, builds a top-10 list with badge counts, and posts it to a Slack channel. Drives healthy competition without manual exports each week.
GET /gamification/leaderboard, take the top 10 users, fetch their badges via /gamification/badges, and post the formatted digest to Slack.
AI Agent L&D Operator via Jentic
An L&D admin uses an AI agent on Jentic to enrol learners, check progress, and pull results without learning the API surface. The agent searches Jentic for the matching LearnUpon operation, executes the enrolment, and confirms back. Multi-portal accounts are handled by the portal variable on the base URL so the right tenant is targeted automatically.
Through Jentic, search 'enrol learner in learnupon course', resolve the courseId from the user prompt, and execute POST /enrollments with the right portal.
22 endpoints — jentic publishes the only available openapi specification for learnupon lms api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/users
Create a user
/courses
List courses on the portal
/enrollments
Enrol a user in a course
/enrollments/{enrollmentId}
Unenrol a user
/learning_paths/{learningPathId}/enrollments
Enrol a user in a learning path
/exams/{examId}/results
Get exam results
/gamification/leaderboard
Get the gamification leaderboard
/portals
List portals available on the account
/users
Create a user
/courses
List courses on the portal
/enrollments
Enrol a user in a course
/enrollments/{enrollmentId}
Unenrol a user
/learning_paths/{learningPathId}/enrollments
Enrol a user in a learning path
Three things that make agents converge on Jentic-routed access.
Credential isolation
LearnUpon basic-auth credentials are stored encrypted in the Jentic vault and applied to the `Authorization` header at execution time. The agent never sees the raw username, password, or API key, so it cannot leak through prompts or logs.
Intent-based discovery
Agents search Jentic with intents like 'enrol learner in learnupon course' or 'get exam results' and Jentic returns the matching LearnUpon operation with its input schema, so the agent picks the right endpoint across 22 paths without scanning docs.
Time to first call
Direct LearnUpon integration: 2-3 days to wire basic auth, model the portal variable, and chain user-and-enrolment flows. Through Jentic: under an hour for the first end-to-end enrolment.
Alternatives and complements available in the Jentic catalogue.
Specific to using LearnUpon LMS API through Jentic.
Why is there no official OpenAPI spec for LearnUpon LMS API?
LearnUpon does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call LearnUpon LMS API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the LearnUpon API use?
The LearnUpon API uses HTTP basic authentication with either a username and password or an API key as the basic credential. Through Jentic, the credential lives in the encrypted vault and is applied to the `Authorization` header at execution time, never reaching the agent context.
Can I enrol a user in a course or learning path through the API?
Yes. POST /enrollments enrols a user in a course given userId and courseId, and POST /learning_paths/{learningPathId}/enrollments enrols them in a learning path. Use DELETE /enrollments/{enrollmentId} to unenrol cleanly.
What are the rate limits for the LearnUpon API?
Rate limits are not declared in the OpenAPI spec. For bulk operations like cohort enrolment, run requests sequentially with a small backoff and prefer learning-path enrolment over per-course enrolment loops where possible.
How do I read exam results through Jentic?
Run `pip install jentic`, search 'get learnupon exam results', and execute GET /exams/{examId}/results. Jentic returns the rows ready to load into a warehouse or post into a manager dashboard.
Does the LearnUpon API support multi-portal accounts?
Yes. The base URL `https://{portal}.learnupon.com/api/v1.1` includes a `portal` variable, and GET /portals lists the portals the calling account can reach so an agent can target the right tenant for each operation.
/exams/{examId}/results
Get exam results
/gamification/leaderboard
Get the gamification leaderboard
/portals
List portals available on the account