Files
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Filefile
A file stored in Vritto: its name, tags, sensitivity, and links.
files_getFileFindthrough vritto_findFetch one asset's metadata by ID.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
files_listAiContextFilesFindthrough vritto_findList available assets in the ai_context scope that are marked AI-exposable, the files AI may cite as grounding context. Rows are compact summaries; use files_getFile for full metadata.
| Field | Type | Description |
|---|---|---|
| detail | one of summary, full | Row shape: "summary" (default, id/name/kind/scope + description preview) or "full" (every field). |
| limit | integer | Max records to return (default 50 in summary mode). |
files_queryFilesFindthrough vritto_findSearch assets by free text with optional kind, scope, sensitivity, module, entity, AI-exposure, and status filters. Returns available assets by default. Rows are compact summaries (name, kind, scope, description preview); use files_getFile or files_resolveFiles for full metadata.
| Field | Type | Description |
|---|---|---|
| query | string | Search query. |
| kind | one of image, document, audio, video, archive, data, other | Asset kind. |
| scope | one of module, profile, ai_context, system | Asset scope (defaults to module). |
| sensitivity | one of normal, private, sensitive | Privacy sensitivity (defaults to normal). 'private' files are readable by AI only when aiExposable is set; 'sensitive' files are never readable by AI and cannot be AI-exposed at all. |
| moduleId | string | Owning or linked module ID. |
| entityId | string | Owning record ID. |
| aiExposable | boolean | Only assets that are (or are not) available to AI. |
| status | one of available, archived, trashed | Filter to one status. |
| includeArchived | boolean | Include archived assets alongside available ones. |
| detail | one of summary, full | Row shape: "summary" (default, id/name/kind/scope + description preview) or "full" (every field incl. full description and render URLs). |
| limit | integer | Max records to return (default 50 in summary mode). |
files_resolveFilesFindthrough vritto_findResolve up to 100 asset IDs to full metadata; missing or deleted IDs are flagged instead of failing.
| Field | Type | Description |
|---|---|---|
| ids* | list of string | Asset IDs to resolve. |
files_restoreFileUpdatethrough vritto_updateRestore an archived or trashed asset back to available.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| expectedRevision* | integer | Current record revision; the write aborts if it changed elsewhere. |
files_setFileArchivedUpdatethrough vritto_updateArchive or unarchive an asset without deleting the file.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| archived* | boolean | True to archive, false to restore. |
| expectedRevision* | integer | Current record revision; the write aborts if it changed elsewhere. |
files_updateFileUpdatethrough vritto_updateUpdate an asset's metadata (name, scope, sensitivity, tags, description, owner link, About person, AI exposure). The file bytes are unchanged. This is a PATCH: a field you omit keeps its stored value, and a field sent as an empty string clears it. Send only what is changing.
| Field | Type | Description |
|---|---|---|
| asset* | object | Fields to change; id and displayName are required. Everything else is optional and omitting it preserves the stored value. |
| asset.id* | string | Asset ID. |
| asset.displayName* | string | Display name. |
| asset.scope | one of module, profile, ai_context, system | Asset scope (defaults to module). |
| asset.sensitivity | one of normal, private, sensitive | Privacy sensitivity (defaults to normal). 'private' files are readable by AI only when aiExposable is set; 'sensitive' files are never readable by AI and cannot be AI-exposed at all. |
| asset.tags | list of string | Tags (unique, case-insensitive). Replaces the whole list when sent; omit to keep the stored tags. |
| asset.description | string | Description. Send an empty string to clear it. |
| asset.moduleId | string | Owning module ID. This is who pays for the file's bytes in the storage report, so clearing it re-attributes them to 'unattributed'. |
| asset.entityId | string | Owning record ID. |
| asset.subjectPersonId | string | Person this document is about (a child's birth certificate, a spouse's passport). Send an empty string to clear it. |
| asset.aiExposable | boolean | Whether AI may use this asset as grounding context. Ignored (forced false) on assets whose sensitivity is 'sensitive'. |
| expectedRevision* | integer | Current record revision; the write aborts if it changed elsewhere. |
files_deleteFileDeletethrough vritto_deleteDelete an asset. By default it moves to trash (recoverable with files_restoreFile for 30 days); with deleteStorageObject true the file is permanently removed.
Note: Deleting moves the file to trash, recoverable for 30 days.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| expectedRevision* | integer | Current record revision; the write aborts if it changed elsewhere. |
| deleteStorageObject | boolean | True to permanently delete the stored file (defaults to false). |
File Linkfile_link
A link attaching a file to a record in another module.
files_listFileUsageFindthrough vritto_findList the active module-record links attached to an asset.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| limit | integer | Max records to return (defaults to 100). |
files_upsertFileUsageCreatethrough vritto_createLink a record in another module to an asset (one active link per module/entity/field).
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| moduleId* | string | Module owning the linked record. |
| entityId* | string | ID of the record in that module. |
| field* | string | Field on the record that links here. |
| labelSnapshot* | string | Display label of the linked record at link time. |
| route | string | In-app route to the linked record. |
files_deleteFileUsageDeletethrough vritto_deleteDeactivate one module-record link to an asset.
| Field | Type | Description |
|---|---|---|
| assetId* | string | Asset ID. |
| moduleId* | string | Module owning the linked record. |
| entityId* | string | ID of the record in that module. |
| field* | string | Field on the record that links here. |
Kept in the Vritto app
files_createFileUploadTarget: Moves file bytes, which MCP apps cannot send or receive here.files_finalizeFileUpload: Moves file bytes, which MCP apps cannot send or receive here.files_getFileDownloadUrl: Moves file bytes, which MCP apps cannot send or receive here.