Users

List User's Imported Resources (DEPRECATED)

get
/api/users/{id}/imports

DEPRECATED (use GET /resources?onlyImported=true instead) List all of the resources the current user has imported.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/0123456789/imports?cursor=abcdefg"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
idstringRequired

The current session user id

Query parameters
cursorstringOptional

An identifier from a prior result to continue retrieving results

Responses
chevron-right
200

List of imported resources

application/json
get
/api/users/{id}/imports

List Available Updates to Resources

get
/api/users/{userId}/updates

List all of the updates to resources the current user has imported.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/0123456789/updates?cursor=abcdefg"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

Query parameters
cursorstringOptional

An identifier from a prior result to continue retrieving results

Responses
chevron-right
200

List of updates to resources available

application/json
get
/api/users/{userId}/updates

Get Update to a Resource

get
/api/users/{userId}/updates/{resourceId}

Get the update information for a resource the current user has imported, if available.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/0123456789/updates/c8d82b560d094c8e82ca0e4e59145e06"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

resourceIdstringRequired

A resource's unique id

Responses
chevron-right
200

Update information for the resource

application/json
updateDateintegerOptional

The date the update was last updated (ISO date string)

createDateintegerOptional

The date the update was created (ISO date string)

lastUpdateDateintegerOptional

The date the version was last updated (ISO date string)

versionIdstringOptional

The unique id of the most recent resource version

versionNotesstringOptional

Notes provided by the sharer regarding the changes in the most recent version

mediaObjectDurationintegerOptional

The duration of the media in seconds

get
/api/users/{userId}/updates/{resourceId}

Ignore Updates

post
/api/users/{userId}/updates/{resourceId}/ignore

Ignore this update for particular courses that previously had imported the resource.

Example: curl -X POST -H "X-Session-ID: 0123456789" -H "Content-Type:application/json" -d '{"courseIds":["123","456"]}' "https://lor.instructure.com/api/users/0123456789/updates/9145e06/ignore"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

resourceIdstringRequired

A resource's unique id

Body
courseIdsstring[]Optional

A list of ids for courses to ignore for this update

Responses
post
/api/users/{userId}/updates/{resourceId}/ignore

No content

List User's Favorite Resources

get
/api/users/{userId}/favorites

List all of the resources the current user has marked as Favorite.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/0123456789/favorites"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

Responses
chevron-right
200

List of favorite resources

application/json
get
/api/users/{userId}/favorites
200

List of favorite resources

Mark Resource as Favorite

post
/api/users/{userId}/favorites

Adds a resource to the current user's favorites list.

Example:

  curl -X POST -H "X-Session-ID: 0123456789" -H "Content-Type: application/json" --data @data.json "https://lor.instructure.com/api/users/1234/favorites"
  data.json:
    {
      "resourceId": "ajk123"
    }
Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

Body
resourceIdstringRequired

The resourceId to mark as favorite

Responses
post
/api/users/{userId}/favorites

Returns Canvas profile URL

get
/api/users/{userId}/profile

Returns the Canvas profile URL for the specified user.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/abcdef/profile"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The ID of the user you want to see in Canvas

Responses
chevron-right
200

Ok

No content

get
/api/users/{userId}/profile

No content

Unmark Resource from Favorites

delete
/api/users/{userId}/favorites/{resourceId}

Remove a resource from the current user's favorites list.

Example: curl -X DELETE -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users/1234/favorites/56789"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Path parameters
userIdstringRequired

The current session user id

resourceIdstringRequired

The resourceId to unflag from user favorites

Responses
delete
/api/users/{userId}/favorites/{resourceId}

No content

Search all users

get
/api/users

Search through a list of all of the users in your account. Only admins and group managers may access this.

Example: curl -H "X-Session-ID: 0123456789" "https://lor.instructure.com/api/users?q=aaron"

Authorizations
x-session-idstringRequired

Session authentication. The session ID can be provided in any of the following ways: [Cookie: 'session'] [Header: 'x-session-id'] [Query parameter: 'session-id'] [Query parameter: first value of 'state'] [Body property: 'sessionId']

Query parameters
qstring · min: 3Required

The text to search for in the name or e-mail of the users. The results will be empty until the minimum length of 3 characters is satisfied.

cursorstringOptional

An identifier from a prior query to continue retrieving results for.

Responses
chevron-right
200

An array of all of the users found matching the search

application/json
get
/api/users

Last updated

Was this helpful?