> ## Documentation Index > Fetch the complete documentation index at: https://docs.kylon.io/llms.txt > Use this file to discover all available pages before exploring further. # file > List, read, write, upload, download, and version workspace files. ```text theme={null} kylon workspace file — kylon workspace help detail file — files visible to you kylon workspace file share create --file [--expires 7d] [--reusable] Agent calls request a Human approval card for an anyone-with-link public snapshot; no link exists before approval. The requesting Human must approve the exact file/assets, expiry, and download setting. File changes require a new approval. Requires Agent file write and turn-read access, and Human file write plus included-asset read access. The server creates the link after approval and delivers its URL in the thread; do not retry create. Human CLI creates directly. Legacy snapshot links require saving the URL; --reusable creates a recoverable URL that changes only through explicit update. Default expiry: never (until revoked); choices: 24h, 7d, 30d, never. kylon workspace file share update --file --link --revision Publish the exact current file snapshot to an existing reusable link. Agent updates require fresh Human snapshot approval; stopped or expired links cannot be reactivated. kylon workspace file share copy --file --link Recover the same active reusable URL with file-write permission. kylon workspace file share stop --file --link Stop access to every revision of a reusable link. kylon workspace file share list --file List share metadata and link IDs without returning public tokens. kylon workspace file share revoke --file --link Stop future access through one share link. Copies already downloaded cannot be recalled. kylon workspace file list [--room ] [--directory ] [--query ] [--type image|video|media|pdf|doc|html] [--since ] [--until ] [--created-by ] Lists files with their IDs, names, types, and sizes. IMPORTANT: omit --room to search the current room only. Use --room all for workspace-wide file search across all visible rooms, or a specific room name/ID to search one room. --directory: filter to files whose storage path starts with the prefix. --query: case-insensitive substring match on file name (SQL-side via trigram). --type: MIME-type bucket — image (image/*), video (video/*), media (image/* or video/*), pdf (application/pdf), doc (text/plain, text/markdown, Word, RTF), html (text/html). --since / --until: ISO-8601 date/datetime, or a dynamic literal like $start_of_today, $start_of_7_days_ago. --created-by: only files uploaded by this user id. Combine with member list first to resolve a user id by name. Use file IDs with attachment fields in Database App records. kylon workspace file get --file Read file metadata and a ready-to-run download command. kylon workspace file url --file [--variant original|thumbnail] Print a temporary signed URL. Prefer file download unless a URL is explicitly needed. kylon workspace file download --file [--output | --dir ] [--variant original|thumbnail] [--force] Download the original file or thumbnail to local disk. Default directory is current working directory. Without --force, explicit --output refuses to overwrite an existing path. kylon workspace file export --file --format pdf|docx [--output ] [--timeout-seconds ] Export a document file to PDF or Word, waiting for the conversion (120 s by default). With --output the artifact is saved there; otherwise its temporary download URL is printed. kylon workspace file upload --source --dest Upload a local file as a versioned shared or room workspace file. If the file presents external research, the Source Link Policy applies inside the file itself, not only in the reply that links it: Cover every externally sourced claim, quote, figure, and table row with its own exact source link, placed on the claim or row it supports. A root, homepage, or profile link does not cite the individual items under it, and a detached source list does not cite an otherwise unlinked claim. To deliver the file in your reply, pass the returned file id to `kylon gateway attach --file `. Do not paste a signed URL from `file url` into a message — it expires and the image breaks. The same file id goes to `thread create`/`thread msg` via `--file-ids ` to attach it inside a thread instead. kylon workspace file read --path Read a text workspace file by path. kylon workspace file write --path --content Write a text workspace file by path. If the file presents external research, the Source Link Policy applies inside the file itself, not only in the reply that links it: Cover every externally sourced claim, quote, figure, and table row with its own exact source link, placed on the claim or row it supports. A root, homepage, or profile link does not cite the individual items under it, and a detached source list does not cite an otherwise unlinked claim. kylon workspace file append --path --content Append text to a workspace file by path. If the file presents external research, the Source Link Policy applies inside the file itself, not only in the reply that links it: Cover every externally sourced claim, quote, figure, and table row with its own exact source link, placed on the claim or row it supports. A root, homepage, or profile link does not cite the individual items under it, and a detached source list does not cite an otherwise unlinked claim. kylon workspace file copy --file --room [--name ] Copy a readable file into a writable room as a new room-scoped file. Use this before sharing a room-scoped file into another room or DM; send the copied file link or file id returned by this command. kylon workspace file delete Delete a room file. Only the file creator or a room admin can delete. Creates a deleted tombstone version and removes the current object; older content versions remain available for file version get / file revert. kylon workspace file versions --file List version history for a file. The current version is marked. kylon workspace file version get --file --version Read metadata and text content for one version. Binary versions return a signed URL. Deleted tombstone versions have no content; revert to an older content version to restore. kylon workspace file revert --file --to-version --expected-current-version Revert by copying an older version into a new current version. The expected current version is required to avoid overwriting newer changes. Resource link handoff: - Emit identified Kylon resources as clickable, path-only markdown links with human-readable labels. - Copy command-returned links verbatim. For context_effect write confirmations, follow the receipt instead; other resources still need links. Otherwise substitute known IDs into the relevant format below; do not guess a path. - File: `[name](/preview/workspaces/{workspaceId}/files/{fileId}?room={roomId})` when room-scoped, or `[name](/preview/workspaces/{workspaceId}/files/{fileId})` for workspace-scoped and agent-private published files. Prefer a tool-returned link when available. --- Dynamic date literals (accepted by --since / --until / filter value) --- They resolve at query time against the caller's clock, so agent-produced queries stay correct across days without rewriting. "$start_of_today" → 00:00 UTC today "$start_of_tomorrow" → 00:00 UTC tomorrow "$start_of_yesterday" → 00:00 UTC yesterday "$start_of_7_days_ago" → 00:00 UTC 7 days ago "$start_of_30_days_ago"→ 00:00 UTC 30 days ago Any ISO-8601 date (2026-04-16) or datetime (2026-04-16T09:00:00Z) also works. Common ranges: Today only: --since $start_of_today --until $start_of_tomorrow Last 7 days: --since $start_of_7_days_ago Last 30 days: --since $start_of_30_days_ago Just yesterday: --since $start_of_yesterday --until $start_of_today Note: quote flag values that contain spaces; follow each command's JSON syntax. ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.