# Users - view list

{% hint style="warning" %}
**Welcome to Our New API Docs!** This is the new home for all things API (previously at [Canvas LMS REST API Documentation](https://api.instructure.com)).
{% endhint %}

## Users - view list

### What it Does

#### Account Navigation

Allows user to access the People link in Account Navigation.

#### Admin Tools (Logging tab)

Allows user to view login/logout activity of users in Admin Tools.

Allows user to search grade change logs by grader or student in Admin Tools.

#### Assignments

Allows user to differentiate assignments to individual students.

#### Collaborations

Allows user to view and add users in a collaboration.

#### Conversations

Allows user to send a message in Conversations without selecting a course.

#### Course Navigation

Allows user to view the People link in Course Navigation.

#### Groups (Course)

Allows user to view groups in a course.

#### People (Account)

Allows user to view list of users in the account.

#### People (Course)

Allows user to view list of users in the course People page.

Allows user to view the Prior Enrollments button in the course People page.

### Additional Considerations

#### Account Groups

To view account-level groups, Groups - manage must also be enabled.

#### Admin Tools (Logging tab)

To generate login/logout activity in Admin Tools, Users - manage login details or Statistics - view must also be enabled.

To generate grade change logs in Admin Tools, Grades - view change logs must also be enabled.

#### Courses

To add or remove users to a course, the appropriate Users permission must be enabled (e.g. Users - Teachers).

#### Groups

To add groups, Groups - add must also be enabled.

To delete groups, Groups - delete must also be enabled.

To edit groups, Groups - manage must also be enabled.

#### People (Account)

To edit user details, modify login details, or change user passwords, Users - manage login details must also be enabled.

To view user page views, Statistics - view must also be enabled.

To act as other users, Users - act as must also be enabled.

#### People (Course)

To edit a user’s section, the appropriate Users permission (e.g. Users - Teachers), Users - allow administrative actions in courses, and Conversations - send to individual course members must also be enabled.

***

This documentation is generated directly from the Canvas LMS source code, available [on Github](https://github.com/instructure/canvas-lms).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developerdocs.instructure.com/services/canvas/permissions/details/file.permissions_read_roster.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.