Clinia
API ReferenceREST API

Browse VFS

GET
/v1/patients/{patientId}/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. Paths are relative to the patient root (e.g. /conditions/active); the patient is identified by the patientId route param. Defaults to the root when path is omitted.

Path Parameters

patientId*string

ID of the patient

Match^[A-Za-z0-9._-]{1,128}$

Query Parameters

path?string

VFS path to browse, relative to the patient root (e.g. /conditions/active). Defaults to the root when omitted.

Default""

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"
}