manage_file
Manage files (path-addressed, versioned content) within a file type. Actions: create (upload text content), get (metadata), list (by path prefix), move (rename), delete. Binary uploads/downloads use the CLI or REST; this tool handles text content and metadata.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
action | enum: create | get | list | move | delete | Yes | |
base_id | string | Yes | Target database ID |
file_type | string | Yes | The file type id |
path | string | No | File path within the file type (e.g. notes/summary.md). Required for create/get/move/delete |
content | string | No | Text content to upload (create). For binary, use the CLI/REST. |
content_type | string | No | MIME type of the content (create); defaults to text/plain |
metadata | object | No | Structured metadata (validated against the file type's metadata_schema) |
if_match | string | No | content_sha256 compare-and-set: write only if the current content hash matches |
new_path | string | No | Destination path for move |
prefix | string | No | Path prefix filter for list |
depth | number | No | Max folder depth below the prefix for list (1 = immediate children) |
limit | number | No | Max results for list |
offset | number | No | Pagination offset for list |