Canvas Career Experiences

Welcome to Our New API Docs! This is the new home for all things API (previously at Canvas LMS REST API Documentation).

Canvas Career Experiences API

API for managing user career experience and role preferences in Canvas.

An ExperienceSummary object looks like:

{
  // The current active experience. One of: 'academic', 'career_learner',
  // 'career_learning_provider'.
  "current_app": "career_learner",
  // List of available experiences for the user. Can include: 'academic',
  // 'career_learner', 'career_learning_provider'.
  "available_apps": ["academic", "career_learner"]
}

Check if Canvas Career is enabled

CareerExperienceController#enabled

GET /api/v1/career/enabled

Scope: url:GET|/api/v1/career/enabled

Returns whether the root account has Canvas Career (Horizon) enabled in at least one subaccount.

Example Request:

curl https://<canvas>/api/v1/career/enabled \
  -H 'Authorization: Bearer <token>'

Example Response:

{"enabled": true}

Get current and available experiences

CareerExperienceController#experience_summary

GET /api/v1/career/experience_summary

Scope: url:GET|/api/v1/career/experience_summary

Returns the current user’s active experience and available experiences they can switch to.

Example Request:

curl https://<canvas>/api/v1/career/experience_summary \
  -H 'Authorization: Bearer <token>'

Returns an ExperienceSummary object.

Switch experience

CareerExperienceController#switch_experience

POST /api/v1/career/switch_experience

Scope: url:POST|/api/v1/career/switch_experience

Switch the current user’s active experience to the specified one.

Request Parameters:

Parameter	Type	Description
experience	Required string	The experience to switch to. Allowed values: academic, career

Example Request:

curl -X POST https://<canvas>/api/v1/career/switch_experience \
  -H 'Authorization: Bearer <token>' \
  -d 'experience=academic'

Switch role

CareerExperienceController#switch_role

POST /api/v1/career/switch_role

Scope: url:POST|/api/v1/career/switch_role

Switch the current user’s role within the current experience.

Request Parameters:

Parameter	Type	Description
role	Required string	The role to switch to. Allowed values: learner, learning_provider

Example Request:

curl -X POST https://<canvas>/api/v1/career/switch_role \
  -H 'Authorization: Bearer <token>' \
  -d 'role=learner'

---

This documentation is generated directly from the Canvas LMS source code, available on Github.