# 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

```json
{
  "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`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/bytes`)
- [`vfs.open(name).appendLines`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/lines`)
- [`vfs.open(name).append`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/append/text`)
- [`vfs.open(name).writeBytes`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/bytes`)
- [`vfs.open(name).writeLines`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/lines`)
- [`vfs.open(name).writeText`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/files/write/text`)
- [`vfs.openById(id).appendBytes`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/append/bytes`)
- [`vfs.openById(id).appendLines`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/append/lines`)
- [`vfs.openById(id).append`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/append/text`)
- [`vfs.openById(id).writeBytes`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/write/bytes`)
- [`vfs.openById(id).writeLines`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/write/lines`)
- [`vfs.openById(id).writeText`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/files/write/text`)
- Inside [`EditResponse`](https://docs.maitento.com/reference/types/edit-response.md)
- Inside [`FileSystemEntry`](https://docs.maitento.com/reference/types/file-system-entry.md)