Analytics preference

We only load Google Analytics after you opt in. You can change this choice at any time from Cookie settings.

Drive

The Drive tab provides a central place to view, manage, and share all files generated by skills.

The Drive tab provides a central place to view, manage, and share all files generated by skills.

Accessing Drive

Navigate to the Drive tab in the dashboard. All files generated by your workflow skills appear here, sorted by creation date.

File List

The file list shows:

  • Name - Original filename with a type-specific icon
  • Type - File MIME type (e.g., pdf, csv, docx)
  • Size - Human-readable file size
  • Source - The node label that generated the file
  • Date - When the file was created
  • Actions - Download, share, and delete buttons

Bulk Actions

Each file you own has a checkbox at the start of its row. Files shared with you through a team are read-only and cannot be selected. Select multiple files (Shift-click selects a contiguous range; the header checkbox selects the whole page) to reveal the bulk action bar above the list, then click Bulk actions to open one dialog that applies the same setting to every selected file:

  • Share all with my teams / Remove team sharing — toggles team sharing for all selected files at once
  • Create share link for each file — creates a share link on every selected file using the same expiry, password, and max-downloads values

The dialog reports how many files it applied to; files you don't own are skipped. The rows-per-page selector (25 / 50 / 100 / All) at the bottom of the list lets you load more files on one page so you can select across your whole Drive.

Sharing Files

Click the Share icon to open the share dialog. You can create multiple share links per file with different configurations and optionally share the file with your current teams.

Create a share link with no password. Anyone with the link can download the file.

Set a password when creating the share. The download URL uses HTTP Basic Authentication - browsers will prompt for username (file) and password when the link is opened.

  • Expires (hours) - Optionally set an expiration time
  • Max downloads - Optionally limit the number of downloads
  • Both can be combined for maximum control

Share With My Teams

Enable Share with my teams to grant read-only access to all teams you currently belong to. Team members can see and download the file from Drive and use read-oriented Drive node operations, but only the file owner can delete the file, create or revoke public links, or change password/TTL/download limits.

The setting is file-specific. If you join or create another team later, toggle sharing again or run the Drive node's shareWithMyTeams operation to add that team. Use unshareWithMyTeams to remove team shares from the file in a workflow.

Managing Shares

The share dialog shows all existing share links with:

  • Current download count
  • Expiration status
  • Whether Basic Auth is enabled
  • Copy and revoke buttons

File Links in Chat & Portal

When a skill generates files during a workflow execution through the Portal chat or Quick Drawer, the download links appear automatically in the response. Users can click to download directly.

Storage

Generated files are stored on the server's filesystem under data/files/. In Docker deployments, this is mounted as a volume for persistence.

Managing Files from Workflows

The Drive node lets you manage Drive files programmatically from within a workflow. Use it to:

  • List your files and return metadata such as filename, MIME type, size, source, and download URL
  • Delete a file after it has been delivered to the user
  • Share or unshare with your teams so team members can read and download it only while the team share exists
  • Set a password on the download link
  • Set a TTL so the link expires after N hours
  • Set a max downloads limit

Converting a file to another format is the Converter node's job, with conversion: "fileConvert". It reads a Drive file and stores the converted result as a new one.

Reference the file by its ID from the skill output: $agentLabel._generated_files[0].id

See the Drive node documentation for configuration details.

Reading Drive Files from Skills

Agent skills can opt into Drive reads with the skill card's Enable Drive files setting. When enabled, the skill runtime includes a generated heym_drive.py helper. Skill code can import helpers such as read_drive_text, read_drive_file, read_drive_base64, get_drive_file, get_drive_file_path, and list_drive_files.

Drive reads are limited to files accessible to the workflow actor: owned files and files shared with the actor through teams. Use a file id for exact lookup, or an exact filename when the user refers to a file by name. Filename lookup returns the newest accessible file with that name; list_drive_files(filename="...") returns all matches.

  • Drive Node - Workflow operations (list, get, delete, password, TTL, max downloads, team sharing)
  • Drive Tab - Browse files in the dashboard
  • File Generation - How _generated_files and download URLs are produced

Cleanup

Expired share tokens are automatically cleaned up daily. Files themselves persist until manually deleted through the Drive tab. Use Clear All to delete every file and their share links in one action.