Courses

Get course information

get

This endpoint will return the course collection information.

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

course_idintegerRequired

ID of the course to get the details of.

Responses

200

After a successful request, the endpoint returns HTTP 200.

application/json

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

404

If course is not found with the provided id, the endpoint returns HTTP 404.

422

Invalid parameters.

get

/courses/{course_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/courses/{course_id} HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "course": {
    "id": 1,
    "name": "text",
    "type": "text",
    "permission": "text",
    "owner": {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text"
    },
    "created_at": "2025-12-27T10:39:50.227Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:39:50.227Z"
  }
}

Get a list of perspectives of a course

get

This endpoint will return all the perspectives in a course.

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

course_idintegerRequired

ID of the course to retrieve perspectives from

Responses

200

After a successful request, the endpoint returns HTTP 200.

application/json

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

404

If course is not found with the provided id, the endpoint returns HTTP 404.

422

Invalid parameters.

get

/courses/{course_id}/perspectives

HTTPcURLJavaScriptPython

GET /api/public/v1/courses/{course_id}/perspectives HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "perspectives": [
    {
      "uuid": "text",
      "title": "text",
      "description": "text",
      "duration": 1,
      "created_at": "2025-12-27T10:39:50.227Z",
      "archived_at": "2025-12-27T10:39:50.227Z",
      "media": {
        "id": 1,
        "title": "text",
        "description": "text",
        "duration": 1,
        "created_at": "2025-12-27T10:39:50.227Z",
        "last_viewed": "2025-12-27",
        "last_viewed_by_student": "2025-12-27",
        "thumbnail_url": "text",
        "transcoding_status": "text",
        "owner": {
          "id": 1,
          "full_name": "text",
          "display_name": "text",
          "email": "text"
        },
        "size": 1,
        "source": "text",
        "embed_id": "text",
        "lti_launch_id": "text",
        "archived_at": "2025-12-27T10:39:50.227Z"
      }
    }
  ]
}