> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/saas-data-monitoring/inventory/inventory-users/teams-users/teams-internal-users.md).

# Teams internal users

Internal users belong to your organization's Teams platform and operate within the organization domains or subdomains.&#x20;

After you filter a specific user's assets, you can [generate a CSV report](#generate-csv-report). The internal users page displays the following data:

* [Internal user list](#internal-user-list)
* [Internal user details](#internal-user-details)
* [Assets](#assets)
* [Events](#events)

## Locate an internal user

To view personal details, asset and event data for a specific internal user in Teams:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Teams** and **Internal**.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FqJqLQvivewLGQnZEzilV%2FTeams%20users.png?alt=media&amp;token=f26978ef-b73c-473e-a682-1bbe75629c72" alt=""><figcaption></figcaption></figure>
3. Filter for a specific user.
4. Click the user's **email address** to open the [internal user details](#internal-user-details).
5. Click any **app** icon to display user details, assets and events for that SaaS app.

## Internal user list

All internal users in your Teams are displayed with these parameters:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FMOeEDSbGaJzEFRZcT0nw%2FTeams%20user%20inventory.png?alt=media&amp;token=28ccda3e-0816-42d2-aee2-96d4eea0a4f0" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="193.9375">Internal user parameter</th><th>Description</th></tr></thead><tbody><tr><td>Email</td><td>Internal user's email address. Click the email to open the <a href="#internal-user-details">internal user details</a> with asset and event data. </td></tr><tr><td>First name</td><td>Internal user's given name</td></tr><tr><td>Last name</td><td>Internal user's surname</td></tr><tr><td>Department</td><td>Organizational department the user belongs to</td></tr><tr><td>Roles</td><td>Organizational role of the user</td></tr><tr><td>Created on</td><td>Date when the user was created in Teams</td></tr><tr><td>Type</td><td>User type in Teams, such as member or admin</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of internal Teams users in CSV format.
{% endhint %}

## Internal user details

Metadata for a specific internal user in Teams is displayed as follows:

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FgqClPkD1UAXRbcgogNuv%2FTeams%20internal%20user%20details.png?alt=media&amp;token=79bd94c5-6fe7-4188-a53d-cfea48b1d78e" alt="" width="375"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="271">Internal user detail</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Internal user name</td></tr><tr><td>Email </td><td>Email of internal user</td></tr><tr><td>Phone</td><td>Phone number of internal user</td></tr><tr><td>User status</td><td>Enabled or disabled</td></tr><tr><td>Job title</td><td>Role of internal user</td></tr><tr><td>Department</td><td>Organizational department the user belongs to</td></tr></tbody></table>

## Assets

View and filter metadata for an internal user's Teams assets.

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Teams** and **Internal**.
3. Filter for a specific user.
4. Click the user's **email address** to open the internal user details.
5. Scroll down to view metadata for the user's Teams assets.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F98Nwu4E0GsDewFR9iFNp%2FOneDrive%20assets.png?alt=media&amp;token=11f5fd48-bbec-43a3-9815-375fc292ec68" alt=""><figcaption><p>Asset details for a specific internal user in Teams</p></figcaption></figure>

The metadata displayed for an internal user's Teams assets includes these parameters:

<table><thead><tr><th width="189.2265625">Asset parameter</th><th>Description</th></tr></thead><tbody><tr><td>Asset name</td><td>Name of file in Teams, including file suffix</td></tr><tr><td>Access type</td><td>The type of link used to share the asset (Anonymous, Direct, etc)</td></tr><tr><td>Sharing status</td><td>If the asset is shared internally, externally or publicly</td></tr><tr><td>Email</td><td>The email of the asset owner or user with Read/Write permissions</td></tr><tr><td>Role</td><td>Roles per access type</td></tr><tr><td>Password protected</td><td>If the file is protected with a password</td></tr><tr><td>Expiration date</td><td>Date when the password expires</td></tr><tr><td>URL</td><td>Link to the file path</td></tr></tbody></table>

### Generate CSV report

You can generate a report for selected asset metadata in CSV format.

1. Select the relevant assets.
2. Click the **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> icon.\
   A consolidated report of asset metadata is downloaded in CSV format.

## Events

DoControl monitors real-time events of user activities in Teams. If no date range is selected, events are displayed from the last 30 days.

#### To view events for a specific internal user:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Teams** and **Internal**.
3. Filter for a specific user.
4. Click the user's **email address** to open the internal user details.
5. Scroll down to view metadata for the user's events in Teams.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F8We6jIC5ak5eYzguh52H%2FTeams%20events.png?alt=media&amp;token=8130d8f4-69de-416b-9528-e0c29b1c32fc" alt=""><figcaption></figcaption></figure>

The metadata displayed for a user's events in Teams includes these parameters:

<table><thead><tr><th width="271">Event parameter</th><th>Description</th></tr></thead><tbody><tr><td>Date and time</td><td>When the event occurred</td></tr><tr><td>Actor </td><td>The user who triggered the event</td></tr><tr><td>Target</td><td>The user whom the actor shared data with</td></tr><tr><td>App</td><td>App involved in the event: Teams</td></tr><tr><td>Asset</td><td>Name of the asset involved. Clicking the link opens the asset details.</td></tr><tr><td>Event type</td><td>Type of event as defined in Teams (File downloaded, etc)</td></tr><tr><td>Triggered</td><td>Number of workflows or alerts that were triggered by this event</td></tr><tr><td>Event ID</td><td>Unique identifier for the event</td></tr><tr><td>Event JSON</td><td>Click to open the JSON file with raw details about the event</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of event metadata for a specific Teams user.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/saas-data-monitoring/inventory/inventory-users/teams-users/teams-internal-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
