Skip to main content
POST
/
files
Upload a file and ensure the parent directories exist. If the file exists, it will be overwritten.
curl --request POST \
  --url https://{port}-{sandboxID}.e2b.app/files \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Access-Token: <api-key>' \
  --form file='@example-file'
[
  {
    "path": "<string>",
    "name": "<string>",
    "type": "file"
  }
]

Authorizations

​
X-Access-Token
string
header
required

Sandbox access token (envdAccessToken) for authenticating requests to a running sandbox. Returned by: POST /sandboxes (on create), POST /sandboxes/{sandboxID}/connect (on connect), POST /sandboxes/{sandboxID}/resume (on resume), and GET /sandboxes/{sandboxID} (for running or paused sandboxes).

Query Parameters

​
path
string

Path to the file, URL encoded. Can be relative to user's home directory.

​
username
string

User used for setting the owner, or resolving relative paths.

​
signature
string

Signature used for file access permission verification.

​
signature_expiration
integer

Signature expiration used for defining the expiration time of the signature.

Body

multipart/form-data
​
file
file

Response

The file was uploaded successfully.

​
path
string
required

Path to the file

​
name
string
required

Name of the file

​
type
enum<string>
required

Type of the file

Available options:
file,
directory