Skip to Content
SeyloDocs
API referenceFiles

Extract an archive

POST
/api/v1/files.extract

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.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
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}$
archivePath*string

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

Lengthlength <= 4096
destination*string

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

Lengthlength <= 4096

Response Body

Success.

application/json
  1. response
Example Request
curl -X POST 'https://example.com/api/v1/files.extract' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "volume": "string",  "archivePath": "string",  "destination": "string"}'
Example Response
{}

Get a download link GET

Returns a one-minute link that downloads a file (any size) from a service volume. Needs `files.read` on the service (a grant on its project covers it). Not available to MCP clients or the assistant.

List a folder GET

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.