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

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# Find and inspect files

> List file artifacts, inspect a record, and view version history from the terminal.

Start here before uploading, downloading, or archiving. Read the file record to confirm the published path, media type, and current version before making changes.

## Before you start

* Confirm the CLI is installed and `atlanai doctor` passes. See [Install atlanai CLI](/tools/cli/how-tos/install).
* Confirm `atlanai auth status` shows the expected account.
* Confirm an active workspace context is set by running `atlanai context show`.

## List files

Returns files in the active workspace. Use `--limit` to cap the number of results returned.

```bash theme={null}
atlanai file list --workspace workspace_123 --limit 20
```

## Inspect file

Returns the full record for a single file artifact, including its published path, media type, and current version.

```bash theme={null}
atlanai file get file_123
```

## View version history

Lists all published versions of a file in order. Use version numbers from this list when downloading a specific version.

```bash theme={null}
atlanai file versions file_123
```

## Troubleshooting

For errors from `file list`, `file get`, or authentication, see [File operation errors](/tools/cli/troubleshooting/file-operation-errors).

## Next steps

* [Upload files](/tools/cli/how-tos/files): Upload a new file or replace an existing one.

## See also

* [Download files](/tools/cli/how-tos/files-download): Download the current or a specific version.
* [Archive files](/tools/cli/how-tos/files-archive): Remove a file from default discovery.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.