Skip to Content
SeyloDocs
API referenceFiles

List a folder

GET
/api/v1/files.list

Lists the files and folders in one folder of a service volume, folders first.

Needs files.read on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
volume*string
Length1 <= length <= 64
nodeId?string

Panel-issued id.

Match^[a-z0-9]{16}$
path?string

Relative to the volume root; "" or "." is the root.

Lengthlength <= 4096

Response Body

Success.

application/json
  1. response
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
path*string
entries*array<>
Example Request
curl -X GET 'https://example.com/api/v1/files.list?serviceId=string&volume=string'
Example Response
{  "nodeId": "string",  "path": "string",  "entries": [    {      "name": "string",      "path": "string",      "isDir": true,      "size": 0,      "mode": 0,      "modifiedAt": "2019-08-24T14:15:22Z",      "symlinkTarget": "string",      "uid": 0,      "gid": 0    }  ]}

Extract an archive POST

Unpacks a .tar.gz or .zip archive into a folder of the same volume, creating the folder if needed. Needs `files.write` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Create a folder POST

Creates a folder, and its missing parents when parents is set. Needs `files.write` on the service (a grant on its project covers it). Available to MCP clients and the assistant.