Open a file
get_fileGet the full text content of one file by id (large files are truncated; use ask_docs for targeted passages). Binary files (images etc.) return a short-lived download link instead. Audited.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fileId | Yes | The id of the file to fetch. | |
| handle | No | Optional: name one of the user's OWN profiles by its public @handle (with or without the leading @), as listed by list_profiles - an alternative to projectId, and it takes precedence if both are given. Honored only for an account-wide connection; a single-project connection is already scoped and ignores it. A handle that is not one of the user's own profiles is refused outright, never quietly swapped for another profile. To read context someone ELSE shared with the user or published, use shared_context instead. | |
| projectId | No | Optional: which of the user's projects holds the file. Honored only for an account-wide connection; a single-project connection is already scoped and ignores this. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| content | No | The file's extracted text. Absent for a binary or image file. | |
| truncated | No | True when the text was truncated at the size guard. | |
| contentType | Yes | ||
| downloadUrl | No | A short-lived download link (valid about 5 minutes). |