Skip to main content

Python package integrating with Litmos User and Teams API

Project description

Documentation Status Travis-CI Build Status Coverage Status Code Quality Status PyPI Package latest release PyPI Package monthly downloads PyPI Wheel Supported versions Supported implementations

Litmos REST API client for python 3.5>

  • Free software: BSD license


pip install litmos-api

Getting started

from litmos import Litmos
litmos = Litmos({apikey}, {source})

# --- User ---
# retrieve users
all_users = litmos.User.all()

# retrieve all users (with all information populated - default /users/all API endpoint only returns a subset of user fields)
# much longer than .all() as individual requests to /find/{user-id} for every user are made
all_users_with_full_details = litmos.User.all(True)

#find user by Id
user = litmos.User.find('rnjx2WaQOa11')

# search for user by username
user ='')

# update JobTitle & City fields
user.JobTitle = 'Pie eater'
user.City = 'Pieland'

# save user

# deactivate user

# create user
user = litmos.User.create({
        'UserName': '',
        'FirstName': 'Jo',
        'LastName': 'Baba72',
        'Email': ''

# remove all teams from user

# delete user
# with Id

# instance

# --- Team ---
# get all teams
all_teams = litmos.Team.all()

# find team by Id
team = litmos.Team.find('rnjx2WaQOa11')

# get team members
users = team.users()

# get team leaders
leaders = team.leaders()

# create team (at root level)
team = litmos.Team.create({'Name': 'A-Team','Description': 'I pity the fool!'})

# add sub-team
sub_team = litmos.Team()
sub_team.Name = 'B-Team'
sub_team.Description = 'Woohoo'

sub_team_id = team.add_sub_team(sub_team)

# assign courses to team
course1 = litmos.Course.find('d2cJSDvIU0c1')
course2 = litmos.Course.find('d2cJSDvIU0c2')
team.assign_courses([course1, course2])

# unassign courses to team
course1 = litmos.Course.find('d2cJSDvIU0c1')
course2 = litmos.Course.find('d2cJSDvIU0c2')
team.unassign_courses([course1, course2])

# --- Team members ---

# add users to team
user1 = litmos.User.find('rnjx2WaQOa11')
user2 = litmos.User.find('rnjx2WaQOa12')
team.add_users([user1, user2])

# remove users from team

# --- Team leaders ---
# promote user

# demote user


To run the all tests run:



0.1.1 (2019-08-19)

  • Add assign and unassign courses methods to Team class.

0.1.0 (2016-12-07)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for litmos-api, version 0.6.0
Filename, size File type Python version Upload date Hashes
Filename, size litmos_api-0.6.0-py2.py3-none-any.whl (9.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size litmos-api-0.6.0.tar.gz (27.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page