Skip to main content
POST
/
v1
/
volumes
/
{id}
/
files
/
write
Write content to a file in a volume
import requests

url = "https://api.13-215-85-171.sslip.io/v1/volumes/{id}/files/write"

payload = {
    "path": "<string>",
    "content": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "name": "<string>",
  "path": "<string>",
  "is_dir": true,
  "size": 123,
  "type": "file",
  "mode": "0644",
  "permissions": "0644",
  "owner": "<string>",
  "group": "<string>",
  "modified_time": "2023-11-07T05:31:56Z",
  "symlink_target": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Path Parameters

​
id
string
required

Volume ID

Body

application/json
​
path
string
required

Absolute volume-internal destination path rooted at /. Relative paths are rejected and .. may not escape the volume root. Volume file routes do not accept sandbox cwd or per-call user semantics. This JSON route is a convenience path for smaller payloads; use direct /file transfers or /uploads/* sessions for large transfers.

​
content
string
required
​
encoding
enum<string>
default:utf8
Available options:
utf8,
base64

Response

File written

​
name
string
required
​
path
string
required

Absolute resolved filesystem path. For sandbox routes this is an absolute sandbox path; for volume routes this is an absolute volume-internal path rooted at /.

​
is_dir
boolean
required
​
size
integer<uint64>
required
​
type
string
required

Entry type (e.g. "file", "directory", "symlink")

Example:

"file"

​
mode
string
Example:

"0644"

​
permissions
string
Example:

"0644"

​
owner
string
​
group
string
​
modified_time
string<date-time>
​
symlink_target
string