FileSystemFile

A file in a file system listing.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
size	integer	The file’s size, in bytes.
name	string	The entry’s name.
path	string	The entry’s full path within the file system.
dateCreated	datetime	When it was created (UTC).
dateModified	datetime	When it was last modified (UTC).

Example

{
  "size": 0,
  "name": "...",
  "path": "...",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateModified": "2026-10-26T12:00:00.0000000Z"
}

Where it’s used

• vfs.open(name).appendBytes (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/bytes)
• vfs.open(name).appendLines (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/lines)
• vfs.open(name).append (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/text)
• vfs.open(name).writeBytes (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/bytes)
• vfs.open(name).writeLines (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/lines)
• vfs.open(name).writeText (PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/text)
• vfs.openById(id).appendBytes (PUT /vfs/by-id/{id}/files/append/bytes)
• vfs.openById(id).appendLines (PUT /vfs/by-id/{id}/files/append/lines)
• vfs.openById(id).append (PUT /vfs/by-id/{id}/files/append/text)
• vfs.openById(id).writeBytes (PUT /vfs/by-id/{id}/files/write/bytes)
• vfs.openById(id).writeLines (PUT /vfs/by-id/{id}/files/write/lines)
• vfs.openById(id).writeText (PUT /vfs/by-id/{id}/files/write/text)
• Inside EditResponse
• Inside FileSystemEntry