manage_file

Manage files (path-addressed, versioned content) within a file type. Actions: create (upload text content, mints a content version), get (metadata; ?version reads a retained one), list (by path prefix), move (rename), delete, history (list content versions), diff (compare two versions — metadata delta + text content diff). 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 | history | diff	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/history/diff
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)
label	string	No	Free-string tag for the content version this create mints (e.g. 'proposal 1')
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)
version	number	No	Read a specific retained content version (get); defaults to the latest
from	number	No	Base version number (diff)
to	number	No	Target version number (diff)
limit	number	No	Max results for list/history
offset	number	No	Pagination offset for list/history