> 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-assets/box-assets.md).

# Box assets

You can use using different [filtering options](#filter-options) to view Box assets for specific [use cases](#use-cases), such as assets shared externally or with collaborators. 

If you discover specific issues, you can activate on-demand [remediation actions](/docontrol-user-guide/workflows/inventory-actions-quick-actions.md).

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F4iFFz9Fc2ekGd1LKfSKZ%2FBox%20assets.png?alt=media&amp;token=0a16a712-389d-4405-bbf6-e047bf05e2f0" alt=""><figcaption></figcaption></figure>

Data for Box assets is displayed according to these columns:

<table><thead><tr><th width="208.33333333333331">Box asset column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Title of file in Box. Click the link to open the individual asset page.</td></tr><tr><td>Owner</td><td>Email address of asset owner. Click the link to open the user page.</td></tr><tr><td>Collaborators</td><td>Internal or external collaborators who have access to assets in your organization.</td></tr><tr><td>Sharing status</td><td><p>If the asset is shared or not: <br>- No sharing link</p><p>- Invited people only<br>- People in your company<br>- People with the link<br>- Internal<br>- External<br></p><p>For more information, see <a href="/docontrol-user-guide/saas-data-monitoring/inventory/inventory-assets.md#box">Box sharing status</a>.</p></td></tr><tr><td>Last viewed by</td><td>Email address of the internal or external actor who last viewed the asset</td></tr><tr><td>Last viewed at</td><td>Date when the asset was last viewed</td></tr><tr><td>Modified at</td><td>Date when asset was updated</td></tr><tr><td>Last modified by</td><td>Email address of person who updated asset</td></tr><tr><td>Asset path</td><td>Relative path of the asset owner in Box</td></tr></tbody></table>

## Filter options

You can use advanced filtering capabilities for asset collaboration in Box, based on collaborator type and collaborator email.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FILH1djExEhKMQ60RiHQ2%2FBox%20filters.png?alt=media&amp;token=910fc17b-e768-4d8c-b2ea-dbb2c952b0e5" alt=""><figcaption><p>Filtering Box assets according to collaborator type</p></figcaption></figure>

Filter options for Box assets include the following:

<table><thead><tr><th width="180">Filter</th><th width="144">Comparator</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>String</td><td><p>Name of Box asset:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Owner</td><td>String</td><td><p>Owner of Box asset:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Sharing status</td><td>Includes or excludes</td><td><p>Type of sharing for the Box asset:</p><p>No sharing link, invited people only, people in your company, people with the link, internal, external</p></td></tr><tr><td>Last viewed by</td><td>String</td><td><p>Internal or external actor who last viewed the Box asset:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain, includes, excludes</p></td></tr><tr><td>Last viewed at</td><td>Date</td><td><p>Date when Box asset was last viewed:</p><p>Equals, after, before, is between</p></td></tr><tr><td>Last viewed</td><td>Boolean</td><td>If the last view date is available:<br>Available or empty</td></tr><tr><td>Modified at</td><td>Date</td><td><p>Date when Box asset was modified:</p><p>Equals, after, before, is between</p></td></tr><tr><td>Asset ID</td><td>String</td><td><p>Unique identifier for Box asset:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Last modified by</td><td>String</td><td><p>User who last modified the Box asset:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Asset path</td><td>String</td><td><p>URL for the asset path:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Type</td><td>Includes or excludes</td><td>Folder or file</td></tr><tr><td>Owner is in group</td><td>Includes or excludes</td><td>Owner belongs to group defined by integrated SaaS app in your organization, such as Okta or Google Drive</td></tr><tr><td>Collaborator type</td><td>Includes or excludes</td><td>Type of collaborator based on permissions:<br>- Uploader<br>- Previewer uploader<br>- Previewer<br>- Co-owner<br>- Viewer<br>- Viewer uploader<br>- Editor</td></tr><tr><td>Collaborator email</td><td>String</td><td><p>Email address of the Box asset collaborator:</p><p>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</p></td></tr><tr><td>Permission type</td><td>Boolean</td><td>Access rights to Box asset:<br>Inherited (from folder) or direct</td></tr></tbody></table>

## Use cases

Common use case filtering examples for Box include:&#x20;

1. Externally shared assets of a specific group from an integrated app such as Okta or BambooHR:\
   `Sharing status excludes People in your company`\
   `Owner is in group includes About to be Terminated`

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F8E10WhC4pbxKUtKV1u3D%2FBox%20use%20case%201.png?alt=media&amp;token=8a58eadc-9ceb-49ac-b9df-08d68bad6ca2" alt=""><figcaption></figcaption></figure>

2. All Box assets that are shared with viewers:\
   `Collaborator type includes Viewer`<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fqz01BzNqfc7xspExzWmA%2Fcollaborator%20filter%20Box.png?alt=media&amp;token=3a719598-5658-49ea-a67b-24c0fec734a8" alt=""><figcaption></figcaption></figure>

3. Remove unused permissions from Box assets that were not viewed for a specific time period.&#x20;

   For example, you can remove external collaborators from assets that were not viewed for the last 13 months:\
   `Last viewed at before 2022-06-01` (date before 13 months)<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FfPCFpuSJ0LGNGZJvEHFc%2FBox%20last%20viewed.png?alt=media&amp;token=10029794-7ac5-4462-b28e-30b37a435b27" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The last view event data is unique to DoControl, and based on past events that were detected by DoControl. The last view indication is visible from the day your organization integrates Box with DoControl.
{% endhint %}

## Inventory actions

Inventory actions are available for Box assets with shared links or collaborators.

{% hint style="success" %}
You can apply inventory actions [in bulk](/docontrol-user-guide/workflows/inventory-actions-quick-actions/box-inventory-actions.md#bulk-actions-in-box) to multiple Box assets, for up to 50,000 permissions.
{% endhint %}

#### To apply inventory actions on Box assets:

1. In the Files view, select one or more specific files.
2. Click the **Remediate** button, and select the relevant inventory action:
   * Remove sharing link
   * Remove external collaborators
   * Remove all collaborators

{% hint style="info" %}
For more information, see [Box inventory actions](/docontrol-user-guide/workflows/inventory-actions-quick-actions/box-inventory-actions.md).
{% 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-assets/box-assets.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.