Skip to Content
SeyloDocs
API referenceFiles

Write a file

POST
/api/v1/files.write

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.

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
content*string
Lengthlength <= 2097152
encoding?|
Default"utf8"
createParents?boolean
Defaultfalse

Response Body

Success.

application/json
  1. response
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
info*
Example Request
curl -X POST 'https://example.com/api/v1/files.write' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "volume": "string",  "path": "string",  "content": "string"}'
Example Response
{  "nodeId": "string",  "info": {    "name": "string",    "path": "string",    "isDir": true,    "size": 0,    "mode": 0,    "modifiedAt": "2019-08-24T14:15:22Z",    "symlinkTarget": "string",    "uid": 0,    "gid": 0  }}

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.

List a git repository's branches GET

Checks access to a git URL (with a stored credential for private repos, like git ls-remote) and lists its branches with the default one. Used to validate a generic git source before saving it. Needs `services.create` on the project. Available to MCP clients and the assistant.