Collection

List all collections the authenticated user has permission to.

get

Authorizations

UserSession

AuthorizationstringRequired

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 collections the authenticated user has permission to.

application/json

401

Authorization information is missing or invalid.

get

/collections

HTTPcURLJavaScriptPython

GET /api/public/v1/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-27T10:20:28.830Z",
      "course_id": 1,
      "archived_at": "2025-12-27T10:20:28.830Z"
    }
  ]
}

Create a new collection with the specified name

post

Authorizations

UserSession

AuthorizationstringRequired

Query parameters

namestringRequired

The name of the collection.

user_idintegerOptional

ID of the user to create the collection on behalf of. If not provided, the collection will be created in the requestor's library

Responses

201

The collection object that was created.

application/json

401

Authorization information is missing or invalid.

403

If a user without permission tries to call this endpoint with user_id parameter, the call is rejected with 403 Forbidden.

404

The user was not found by id.

422

Invalid user_id is provided.

post

/collections

HTTPcURLJavaScriptPython

POST /api/public/v1/collections?name=text 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-27T10:20:28.830Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:20:28.830Z"
  }
}

Get data of a collection

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Responses

200

The collection 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 collection was not found.

422

Invalid collection_id is provided.

get

/collections/{collection_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/collections/{collection_id} 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-27T10:20:28.830Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:20:28.830Z"
  }
}

Deletes the specified collection and all related media and perspectives.

delete

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Responses

200

The collection 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 collection was not found.

422

Invalid collection_id is provided.

delete

/collections/{collection_id}

HTTPcURLJavaScriptPython

DELETE /api/public/v1/collections/{collection_id} 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-27T10:20:28.830Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:20:28.830Z"
  }
}

Archives the specified collection and all related media and perspectives.

post

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Responses

200

The collection was archived.

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 collection was not found.

422

Invalid collection_id is provided.

post

/collections/{collection_id}/archive

HTTPcURLJavaScriptPython

POST /api/public/v1/collections/{collection_id}/archive 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-27T10:20:28.830Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:20:28.830Z"
  }
}

List media in a specific collection

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection

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 media in a specific 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 collection was not found by ID.

get

/collections/{collection_id}/media

HTTPcURLJavaScriptPython

GET /api/public/v1/collections/{collection_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-27T10:20:28.830Z",
      "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:20:28.830Z"
    }
  ]
}

Get users and groups who have access to the collection

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Responses

200

List of users and groups extended with permission type.

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 collection was not found.

422

Invalid collection_id is provided.

get

/collections/{collection_id}/permissions

HTTPcURLJavaScriptPython

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

{
  "users": [
    {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text",
      "permission": "text"
    }
  ],
  "groups": [
    {
      "id": 1,
      "name": "text",
      "permission": "text"
    }
  ]
}

Add permissions to the collection

post

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Body

application/json

Responses

200

Permissions were added, the updated list of permissions is returned.

application/json

400

One ore more permission was not found or can not be created, because already exists

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 collection was not found.

422

Invalid collection_id is provided.

post

/collections/{collection_id}/permissions

HTTPcURLJavaScriptPython

POST /api/public/v1/collections/{collection_id}/permissions HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "permissions": [
    {
      "action": "create",
      "id": 1,
      "share_type": "user",
      "permission_type": "view"
    }
  ]
}

{
  "users": [
    {
      "id": 1,
      "full_name": "text",
      "display_name": "text",
      "email": "text",
      "permission": "text"
    }
  ],
  "groups": [
    {
      "id": 1,
      "name": "text",
      "permission": "text"
    }
  ]
}

Unarchives the specified collection and all related media and perspectives.

post

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

collection_idinteger · int64Required

The ID of the collection.

Responses

200

The collection was unarchived.

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 collection was not found.

422

Invalid collection_id is provided.

post

/collections/{collection_id}/unarchive

HTTPcURLJavaScriptPython

POST /api/public/v1/collections/{collection_id}/unarchive 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-27T10:20:28.830Z",
    "course_id": 1,
    "archived_at": "2025-12-27T10:20:28.830Z"
  }
}