Files in a space

Upload documents and audio, watch them process, and preview them in the file drawer.
View as Markdown

The Files tab is a space’s file pool: a single flat table — no folders, no tags. Every file you upload lives here, alongside files that runs and actions generate.

Uploading files

Add files two ways:

  • Click Upload files and pick them.
  • Drag and drop files onto the panel. An overlay appears — “Drop files to upload” / “Release to add them to this space.”

A placeholder row shows while an upload is in flight.

The table

Each file is a row with these columns:

ColumnWhat it shows
NameThe file name, with a type icon and size. Click it to open the detail drawer.
UploadedWhen the file was added.
ActionsPer-row Download and Delete.

Filter the list with the Search by file name box. Select one or more files to reveal a bulk toolbar with Run action, Download, Delete, and Clear. Run action launches a single-action run over the selected files — see Run an action.

Processing states

After upload, each file moves through processing, shown as a status badge:

Uploading → Stored → Processing → Processed

A file that can’t be processed shows Failed. Download stays disabled while a file is still Uploading.

Processing automatically indexes each file for the Search tab and, for documents, builds the space’s Graph — no per-file toggle. See Search and the knowledge graph.

The file detail drawer

Click a file name to open its drawer. It shows the filename, a type badge, a status badge, the size and date, and a Download button. What you can preview depends on the type:

PDFs preview inline in an embedded viewer.

Images render inline.

Audio files get a player with a synced transcript. The segment under the playhead is highlighted and auto-scrolls; click any segment to seek the player to it. Speakers are labeled Speaker N with mm:ss timecodes.

“Preview isn’t available for this file type. Download the file to review it.”

If a file Failed, the drawer shows “Processing failed” and a Try processing again button to retry.

The Files tab table with a file drawer open, showing the PDF badge, Processed status, Download button, and an inline invoice preview

Need programmatic access to files and their parsed output? See the Developers tab.