POST
/
api
/
filesystem
/
list
curl --request POST \
  --url http://localhost:4242/{computer_name}/api/filesystem/list \
  --header 'Content-Type: application/json' \
  --data '{
  "include_hidden": false,
  "path": "/home/user/documents",
  "pattern": "*.txt"
}'
[
  {
    "name": "document.txt",
    "path": "/home/user/documents/document.txt",
    "type": "file",
    "size": 1024,
    "modified_time": "2024-03-10T12:34:56",
    "is_hidden": false,
    "extension": "txt"
  }
]

Body

application/json
​
path
string
required

Directory path to list

Example:

"/home/user/documents"

​
include_hidden
boolean
default:false

Whether to include hidden files/directories

Example:

false

​
pattern
string | null

Glob pattern to filter results

Example:

"*.txt"

Response

200
application/json
Successfully listed directory contents
​
name
string
required

File or directory name

Example:

"document.txt"

​
path
string
required

Full path to the file or directory

Example:

"/home/user/documents/document.txt"

​
type
string
required

Type of entry: 'file' or 'directory'

Example:

"file"

​
size
integer
required

Size in bytes

Example:

1024

​
modified_time
string
required

Last modification time

Example:

"2024-03-10T12:34:56"

​
is_hidden
boolean
required

Whether the file/directory is hidden

Example:

false

​
extension
string | null

File extension if applicable

Example:

"txt"