Skip to main content
POST
/
v1
/
sandboxes
/
{id}
/
files
/
upload-url
Get a direct upload URL
import requests

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

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

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

print(response.text)
{
  "url": "<string>",
  "token": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Path Parameters

​
id
string
required

Sandbox ID (e.g. sb_a1b2c3d4)

Body

application/json
​
path
string
required

Sandbox path to target. Absolute paths may target valid sandbox locations such as /workspace, /data, /tmp, or /context where present. Relative paths resolve from the sandbox cwd when set, otherwise from the selected user's home when user is provided, otherwise from /workspace.

​
user
string

Optional sandbox user for relative-path resolution and ownership.

Response

200 - application/json

Direct upload URL

​
url
string
required

A sandbox-scoped URL for direct upload with a short-lived file transfer token.

​
token
string
required

Compatibility copy of the scoped file transfer token embedded in the URL.