Skip to main content
POST
/
sandboxes
/
{sandbox_id}
/
files
Write File
curl --request POST \
  --url https://api.declaw.ai/sandboxes/{sandbox_id}/files \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "path": "<string>",
  "data": "<string>",
  "username": "<string>"
}
'
Writes a file to the specified path inside the sandbox. If the file already exists it is overwritten. Parent directories are created automatically if they do not exist. Returns the envd write response.

​
Path Parameters

​
sandbox_id
string
required
The sandbox identifier. Format: sbx-<8 chars>.

​
Request Body

​
path
string
required
Absolute path to write inside the sandbox. Parent directories are created automatically.Example: "/home/user/script.py"
​
data
string
required
File content as a string. For binary files, pass base64-encoded content.Example: "print('hello')\n"
​
username
string
Unix user to own the written file. Defaults to the envd default user.Example: "user"

​
Response

Returns the envd write confirmation as a JSON object.

​
Example

curl -X POST https://api.declaw.ai/sandboxes/sbx-a1b2c3d4/files \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "/home/user/script.py",
    "data": "print(\"hello\")\n"
  }'

​
Error Responses

StatusCause
400Invalid request body
401Missing or invalid API key
404Sandbox not found
409Sandbox is paused — resume it before accessing files
410Sandbox has been killed
502envd daemon unreachable
503Sandbox has no VM