Introduction
Institution-Level User APIs are a set of JSON APIs that allow a client to programmatically manage users within the institution.
Set-Up
Prior to using the Org-Level User Management APIs, you will need to request an API Key and Secret. Then, you will connect it to your preferred course(s) and/or link it to your whole institution.
This article, How to Request and Set Up an API Key and Secret, walks through the process of requesting and setting up the API Key and Secret.
Endpoints
There are eight endpoints:
- GET Available roles
- GET Custom Profile List
- PUT Update Custom Profile
- PUT Update Email
- PUT Update External ID
- GET User
- PUT Update User
- POST Create User
Developer Documentation
Rate Limiting
We ensure the integrity of our API endpoints, NovoEd limits usage of our API on a per-key basis. Here are the rate limits:
Time Span |
Request Limit |
1 Minute |
200 |
1 Hour |
1000 |
1 Day |
13000 |
“Time span” is determined by when a request first comes in. Within the next time span, the requestor cannot exhaust the number of requests allowed within that time period.