# FileSystemEntry

An entry in a file system directory listing: a file or a directory.

**Kind:** one of several shapes, used in responses.

## Shapes

The `$type` field says which shape it is, and comes first.

| `$type` | Shape |
|---|---|
| `"directory"` | [`FileSystemDirectory`](https://docs.maitento.com/reference/types/file-system-directory.md) |
| `"file"` | [`FileSystemFile`](https://docs.maitento.com/reference/types/file-system-file.md) |

## Example

```json
{
  "$type": "directory",
  "name": "...",
  "path": "...",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateModified": "2026-10-26T12:00:00.0000000Z"
}
```

## Where it's used

- [`vfs.open(name).copy`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /namespaces/{namespaceName}/vfs/by-name/{name}/copy`)
- [`vfs.open(name).list`](https://docs.maitento.com/reference/api/vfs.md) (`GET /namespaces/{namespaceName}/vfs/by-name/{name}/directories/contents`)
- [`vfs.open(name).move`](https://docs.maitento.com/reference/api/vfs.md) (`POST /namespaces/{namespaceName}/vfs/by-name/{name}/move`)
- [`vfs.openById(id).copy`](https://docs.maitento.com/reference/api/vfs.md) (`PUT /vfs/by-id/{id}/copy`)
- [`vfs.openById(id).list`](https://docs.maitento.com/reference/api/vfs.md) (`GET /vfs/by-id/{id}/directories/contents`)
- [`vfs.openById(id).move`](https://docs.maitento.com/reference/api/vfs.md) (`POST /vfs/by-id/{id}/move`)
