> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/file-manager/overview.md).

# Overview

## User Guide: File Manager Tab <a href="#user-guide-chat-manager-tab" id="user-guide-chat-manager-tab"></a>

BlueFletch provides the option of hosting APK packages and other files within the BlueFletch Portal through its File Manager feature. File Manager simplifies hosting files that will be provided to the Launcher via [assets](/bluefletch-enterprise/product-guides/bluefletch-launcher/launcher3/configurable-layouts/assets-manager.md) or [plays](/bluefletch-enterprise/product-guides/portal/playbook-mdm/plays.md). A mobile device admin can share these files to a device without having to use another service to host the files. The BlueFletch Portal's Playbook Tools can retrieve files programmatically from File Manager, removing the need to copy and paste the URL from a hosting platform.

### Using the File Manager

Find the ***File Manager*** tab in the left hand navigation panel. If you do not have this tab and are interested in adding it to your BlueFletch Portal, contact your BlueFletch sales representative.

<figure><img src="/files/J7ELvzW6CdCVsMY5Wtk9" alt=""><figcaption></figcaption></figure>

The File Manager has two sub-tabs: ***Files*** and ***Applications.*** ***Files*** is for all file types that are not APKs (which are hosted in ***Applications***).

#### Add a File or Application

1. Click **Upload**.\
   \
   ![](/files/tvCEPlEMmIrqzWTUw6Nb)<br>
2. Select **Files** or **Applications**.
   1. For a file, select the desired file from your computer's file explorer, or drag-and-drop the file.
   2. For an application:
      1. Select or drag-and-drop the file.
      2. Enter the "Application Name", "Version", "Package Name" (all required), and "Description" (optional).\
         \
         ![](/files/TqrugrGS6mH6d0NSDnSC)<br>
3. Click **Start Upload**.

#### Retrieving Files

1. Select the **Files** or **Applications** sub-tab.
2. Select if you want to **Copy URL**, **Preview/View**, **Download**, or **Delete** the file/app.
3. To use a file as an asset in the BlueFletch Launcher:

   1. Click **Copy URL**.
   2. In the launcher.json configuration file, in the "assets" object give the file a key name (any string).
   3. Paste the URL.
   4. To be able to retrieve the URL over the network, append the organization's BlueFletch API key (found in the ***Admin - Security*** tab under **Legacy API Key**) to the end of the URL using the format `?apikey=insert_API_key_here`).

   **Example:**

<pre class="language-json"><code class="lang-json">"assets": {
    ...
<strong>    "portalHostedFile": "https://ems-services-portal.bluefletch.com/services/apiv1/files/downloadClientFile/xxxxxxx-1234-5678-xxxx-xxxxxxxxxxx?apikey=xxxxxxxxxxxxxPg67hF998xxxxxxxxxxxxxx"
</strong>}
</code></pre>


---

# 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 dynamically by asking a question.

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

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/file-manager/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
