> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Files

> Your company's file library, and how to share files with agents.

Every company has a shared file library — a single place to store documents that your agents can work with, organized like a normal folder structure.

## Your file library

Go to **Files** in the sidebar. Files are organized into folders you create; upload by clicking **Upload** or by dragging files directly into a folder.

<Steps>
  <Step title="Create folders">
    Organize by topic, project, or agent — whatever makes sense for your team.
  </Step>

  <Step title="Upload files">
    Click **Upload**, or drag and drop files anywhere in the file grid.
  </Step>

  <Step title="Preview, rename, or delete">
    Open a file to preview it in the browser, or use the actions menu to rename or delete it.
  </Step>

  <Step title="Download">
    Get the original file back out at any time.
  </Step>
</Steps>

## Previews

Many common formats preview directly in the browser, no download required: Markdown, CSV, JSON, PDF, HTML, images, video, audio, plain text, and source code.

## Sharing files with an agent

File access is granted per agent, from that agent's own page — open the **Shared files** panel in the side panel to manage it:

| Option                 | What it does                                                                                             |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| **Share from library** | Pick existing files or folders from your company's file library and grant the agent read access to them. |
| **Add files**          | Upload directly into a folder dedicated to that agent — both you and the agent can add files there.      |

<Tip>
  Files an agent creates on its own — reports it writes, exports it generates — show up in the shared files panel automatically, tagged **Agent**, and also land back in your main file library.
</Tip>

<Warning>
  **Revoke** removes a shared file's access from the agent without deleting it from your library. It's only available for files you explicitly shared — files the agent created itself aren't revocable from this panel, since they're the agent's own output rather than something granted to it.
</Warning>

## Related

<CardGroup cols={2}>
  <Card title="Chat" icon="messages" href="/guides/chat">
    The side panel where file sharing lives.
  </Card>

  <Card title="Activity" icon="chart-line" href="/guides/activity">
    See when an agent reads or writes a file.
  </Card>
</CardGroup>