Skip to Content
SeyloDocs
API referenceFiles

Rename or move a file

POST
/api/v1/files.rename

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.

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}$
from*string

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

Lengthlength <= 4096
to*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.rename' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "volume": "string",  "from": "string",  "to": "string"}'
Example Response
{}

Read a file GET

Returns a file's content for the editor: UTF-8 text, or base64 for binary files. Files over 1 MiB fail with BAD_REQUEST; use files.downloadTicket for those. Needs `files.read` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Get an upload link POST

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.