Course Outline API Plugin
A django app plugin to add a new API to Open edX that returns a course outline summary (one entry per chapter) for a given course.
Version Compatibility
For this plugin’s compatibility with Open edX, see the Open edX Release Compatibility table.
Installation
For detailed installation instructions, please refer to the plugin installation guide.
Installation required in:
LMS
How To Use
The API supports a GET call to:
<LMS_BASE>/api/ol-course-outline/v0/<course_id>/
The endpoint is protected by the platform API auth and requires an admin user (DRF IsAdminUser).
The successful response for http://local.openedx.io:8000/api/ol-course-outline/v0/course-v1:edX+DemoX+Demo_Course/ would look like:
{
"course_id": "course-v1:edX+DemoX+Demo_Course",
"generated_at": "2026-03-17T12:34:56Z",
"modules": [
{
"id": "block-v1:edX+DemoX+Demo_Course+type@chapter+block@1414ffd5143b4b5",
"title": "Example Week 1: Getting Started",
"effort_time": 121,
"effort_activities": 1,
"counts": {
"videos": 5,
"readings": 3,
"problems": 2,
"assignments": 1,
"app_items": 0
}
}
]
}
Notes
generated_at is the timestamp when the outline was built (cached responses return the same value).
effort_time and effort_activities come from the platform Effort Estimation transformer via the Blocks API.
counts are computed by walking the Blocks API tree under each chapter (staff-only blocks are excluded): - videos: blocks with type video - readings: blocks with type html - problems: blocks with type problem - assignments: sequential blocks that are graded or have a non-empty format (except notgraded) - app_items: leaf blocks that are not video, html, or problem (and not container types)
Caching
This endpoint caches the full JSON response using Django’s configured cache backend.
TTL: configurable via OL_COURSE_OUTLINE_API_CACHE_TIMEOUT_SECONDS (default: 1 week).
Cache key: <prefix>s<schema_version>:<course_key>:<content_version>. - prefix is configurable via OL_COURSE_OUTLINE_API_CACHE_KEY_PREFIX (default: ol_course_outline_api:outline:v0:). - schema_version is a plugin constant (bump it when you change the response shape or computation logic). - content_version is course.course_version when present; otherwise the key uses na.
Invalidation: - Publishing a course that updates course.course_version produces a new cache key, effectively invalidating old entries.
Troubleshooting
Page not found (404): ensure the plugin is installed in the LMS and the URLs are registered.
Course ID in the URL: course keys contain +. Use URL-encoded form (%2B) when needed, e.g. /api/ol-course-outline/v0/course-v1:OpenedX%2BDemoX%2BDemoCourse/.
Metadata
Release files for ol-openedx-course-outline-api 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ol_openedx_course_outline_api-0.2.0.tar.gz | 7.0 kB | Without provenance | Details for ol_openedx_course_outline_api-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ol_openedx_course_outline_api-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for ol_openedx_course_outline_api-0.2.0-py3-none-any.whl |
Total release size: 17.1 kB
Release files / ol_openedx_course_outline_api-0.2.0.tar.gz
| Download URL | ol_openedx_course_outline_api-0.2.0.tar.gz |
|---|---|
| Size | 7.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4560ced2799070095b5ec7b04f0290fa4696aac6bc31bfd9c47d2115adb9bda3
|
|
BLAKE2b-256 checksum How to use checksums |
9536b513a8bacc9196858e1dd7680dda25c05113d9692a024a3bbfb528d96075
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / ol_openedx_course_outline_api-0.2.0-py3-none-any.whl
| Download URL | ol_openedx_course_outline_api-0.2.0-py3-none-any.whl |
|---|---|
| Size | 10.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f90275697dc6596a17747f874d25ff91e433edce9ee79981ea464b4455620fd1
|
|
BLAKE2b-256 checksum How to use checksums |
98a071bf3a5135278c24cf3f665fea9968471266f8876bb3b07c568b459214bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for ol-openedx-course-outline-api 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.