Browse VFS
Lists the contents of a VFS path. Returns directory children with name, type, and preview, or file content when the path resolves to a file. Defaults to the root when path is omitted. The patientId here is the registry key; VFS paths internally use the patient ID extracted from the ingested record.
Path Parameters
Registry key of the patient, as assigned by the caller when the first ingest was submitted.
^[A-Za-z0-9._-]{1,128}$Query Parameters
Absolute VFS path to browse. Defaults to the root when omitted.
""Response Body
application/json
application/json
curl -X GET "https://example.com/v1/patients/patient-123/vfs"{
"path": "string",
"type": "directory",
"children": [
{
"name": "string",
"type": "directory",
"preview": "string"
}
],
"content": "string"
}{
"code": 1,
"type": "ALREADY_EXISTS",
"message": "string"
}Close session DELETE
Closes an active session. Closed sessions remain readable but accept no further interactions.
Read VFS path GET
Returns the content of a VFS file at the given path. Three output formats are supported: `narrative` (full Markdown, default), `compact` (condensed Markdown), and `structured` (machine-readable JSON). Use `token_budget` to cap approximate output length in tokens.