Skip to Content
SeyloDocs
API referenceFiles

Get an upload link

POST
/api/v1/files.uploadTicket

Returns a one-minute link that accepts one file upload (PUT with the raw body, any size) into a folder of a service volume. An existing file with that name is replaced.

Needs files.write on the service (a grant on its project covers it). Not available to MCP clients or 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}$
path*string

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

Lengthlength <= 4096
sizeBytes?integer
Range0 <= value
createParents?boolean
Defaulttrue

Response Body

Success.

application/json
  1. response
url*string
ticket*string
expiresAt*string
Formatdate-time
Example Request
curl -X POST 'https://example.com/api/v1/files.uploadTicket' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "volume": "string",  "path": "string"}'
Example Response
{  "url": "string",  "ticket": "string",  "expiresAt": "2019-08-24T14:15:22Z"}

Rename or move a file POST

Renames or moves a file or folder inside the same volume. Fails with CONFLICT when the destination exists. Needs `files.write` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Write a file POST

Creates or replaces a file with the given content (up to 1 MiB). Existing files keep their mode. Needs `files.write` on the service (a grant on its project covers it). Available to MCP clients and the assistant.