Endpoints

  • GET /learning-paths - list learning paths
  • GET /learning-paths/{learningPathId} - get details of a learning path by learning path id
  • GET /learning-paths/{learningPathId}/courses - list courses in a learning path by learning path id

Learning Path Object

  • id (string) - the unique identifier of the learning path
  • title (string) - title of the learning path
  • description (string) - description of the learning path
  • coverImageUrl (string) - URL for the learning path cover image (if any)
  • coursesUrl (string) - URL to fetch the list of courses in the learning path from the API
  • coursesReportUrl (string) - URL to fetch the learning path courses report from the API
  • learnersReportUrl (string) - URL to fetch the learning path learners report from the API
  • url (string) - URL to fetch the learning path's details from the API

List Learning Paths

GET /learning-paths

Parameters

  • limit (integer, optional) - the maximum number of results to return in a single response (defaults to 50)

Example Response

{ 
"learningPaths": [
{
"id": "example-learning-path-1",
"title": "Learning Path Title",
"description": "A simple learning path",
"coverImageUrl": null,
"coursesUrl": "https://api.rise.com/learning-paths/example-learning-path-1/courses",
"coursesReportUrl": "https://api.rise.com/reports/learning-paths/example-learning-path-1/courses",
"learnersReportUrl": "https://api.rise.com/reports/learning-paths/example-learning-path-1/learners",
"url": "https://api.rise.com/learning-paths/example-learning-path-1"
}, ...
],
"nextUrl": "https://url-for-next-page-of-results"
}

Retrieve Learning Path by ID

GET /learning-paths/{learningPathId}

Example Response

{ 
"id": "example-learning-path",
"title": "Learning Path Title",
"description": "A simple learning path",
"coverImageUrl": null,
"coursesUrl": "https://api.rise.com/learning-paths/example-learning-path/courses",
"coursesReportUrl": "https://api.rise.com/reports/learning-paths/example-learning-path/courses",
"learnersReportUrl": "https://api.rise.com/reports/learning-paths/example-learning-path/learners",
"url": "https://api.rise.com/learning-paths/example-learning-path"
}

Endpoint-specific error codes

  • learning_path_not_found - cannot retrieve learning path because learning path does not exist

Retrieve Learning Path Courses by Learning Path ID

GET /learning-paths/{learningPathId}/courses

Parameters

  • limit (integer, optional) - the maximum number of results to return in a single response (defaults to 50)

Example Response

{ 
"learningPathUrl": "https://api.rise.com/learning-paths/example-learning-path",
"courses": [
{
"id": "example-course-id-1",
"title": "Course Title",
"coverImageUrl": null,
"authorUrl": "https://api.rise.com/users/author-user-id",
"courseReportUrl": "https://api.rise.com/reports/courses/example-course-id-1",
"url": "https://api.rise.com/courses/example-course-id-1"
}, ...
],
"nextUrl": "https://url-for-next-page-of-results"
}

Endpoint-specific error codes

  • learning_path_not_found - cannot list courses because learning path does not exist
Did this answer your question?