User

Get all collections the user has access to.

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

user_idinteger · int64Required

The ID of the user.

Query parameters

pageintegerOptional

The page to retrieve. Default: 1.

Default: 1

per_pageinteger · max: 50Optional

The number of results per page. Default: 20, Max: 50.

Default: 20

Responses

200

The list of collections the user has access to, with permissions.

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

The user was not found.

422

Invalid parameters.

get

/users/{user_id}/collections

HTTPcURLJavaScriptPython

GET /api/public/v1/users/{user_id}/collections HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "collections": [
    {
      "id": 1,
      "name": "text",
      "type": "text",
      "permission": "text",
      "owner": {
        "id": 1,
        "full_name": "text",
        "display_name": "text",
        "email": "text"
      },
      "created_at": "2025-12-27T12:08:26.172Z",
      "course_id": 1,
      "archived_at": "2025-12-27T12:08:26.172Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "total_count": 1
  }
}

Get the user's "My Library" collection.

get

Returns the user's personal collection (type: user). This is the default collection where users store their personal media.

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

user_idinteger · int64Required

The ID of the user.

Responses

200

The user's My Library collection.

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

The user was not found.

422

Invalid parameters.

get

/users/{user_id}/library

HTTPcURLJavaScriptPython

GET /api/public/v1/users/{user_id}/library HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "collection": {
    "id": 1,
    "name": "text",
    "type": "text",
    "permission": "text",
    "owner": {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text"
    },
    "created_at": "2025-12-27T12:08:26.172Z",
    "course_id": 1,
    "archived_at": "2025-12-27T12:08:26.172Z"
  }
}

Get a list of media the user has access to.

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

user_idinteger · int64Required

The ID of the user.

Query parameters

pageintegerOptional

The page to retrieve. Default: 1.

Default: 1

per_pageinteger · max: 50Optional

The number of results per page. Default: 20, Max: 50.

Default: 20

Responses

200

The requested media list extended with permission of the user on the media.

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

The user was not found.

422

Invalid parameters.

get

/users/{user_id}/media

HTTPcURLJavaScriptPython

GET /api/public/v1/users/{user_id}/media HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "media": [
    {
      "id": 1,
      "title": "text",
      "description": "text",
      "duration": 1,
      "created_at": "2025-12-27T12:08:26.172Z",
      "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-27T12:08:26.172Z",
      "permission": "text"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "total_count": 1
  }
}

Get data of a user

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

user_idinteger · int64Required

The ID of the user.

Responses

200

The user object.

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

The user was not found.

422

Invalid parameters.

get

/users/{user_id}

HTTPcURLJavaScriptPython

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

{
  "user": {
    "id": 1,
    "full_name": "text",
    "display_name": "text",
    "email": "text",
    "role_names": [
      "text"
    ]
  }
}

Search users.

get

Authorizations

UserSession

AuthorizationstringRequired

Query parameters

rolestring · enumOptional

A role to filter the users by.

Possible values:

emailstringOptional

Email address of the user.

pageintegerOptional

The page to retrieve. Default: 1.

Default: 1

per_pageinteger · max: 50Optional

The number of results per page. Default: 20, Max: 50.

Default: 20

Responses

200

The list of user objects.

application/json

400

Required parameter is missing.

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.

422

Invalid parameters.

get

/users/search

HTTPcURLJavaScriptPython

GET /api/public/v1/users/search HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "users": [
    {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text",
      "role_names": [
        "text"
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "total_count": 1
  }
}

Add/Remove roles from users

put

Authorizations

UserSession

AuthorizationstringRequired

Body

application/json

Responses

200

Role updates are successfully applied, the updated list of user objects

application/json

400

Required parameter is missing.

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

The user(s) was not found.

422

Invalid parameters.

put

/users/roles

HTTPcURLJavaScriptPython

PUT /api/public/v1/users/roles HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "actions": [
    {
      "user_id": 1,
      "action": "add",
      "role": "Admin"
    }
  ]
}

{
  "users": [
    {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text",
      "role_names": [
        "text"
      ]
    }
  ]
}