upload

Upload a file to Contree.

TL;DR

Use when: Single file, generated content
Returns: File UUID for use with run
Cost: No VM needed
Prefer: rsync for multiple files (has caching)

Parameters

Parameter	Type	Required	Default	Description
`content`	string	No*	-	Text content
`content_base64`	string	No*	-	Base64-encoded binary
`path`	string	No*	-	Absolute path to a file on local filesystem to read and upload. Not a destination name — files are content-addressable (UUID). To name the file in a container, use `run`’s `files` parameter.

*One of content, content_base64, or path is required.

Response

{
  "uuid": "file-uuid-123",
  "sha256": "abc123..."
}

Examples

Text Content

{"tool": "upload", "args": {
  "content": "print('hello world')"
}}

Local File

{"tool": "upload", "args": {
  "path": "/path/to/script.py"
}}

Binary (Base64)

{"tool": "upload", "args": {
  "content_base64": "SGVsbG8gV29ybGQ="
}}

Using the Result

Pass the UUID to run via the files parameter:

// Step 1: Upload
{"tool": "upload", "args": {"content": "print('hello')"}}
// Returns: {"uuid": "file-uuid-123"}

// Step 2: Run
{"tool": "run", "args": {
  "command": "python /app/script.py",
  "image": "img-uuid",
  "files": {"/app/script.py": "file-uuid-123"}
}}

Common Mistake

path reads from the local MCP-server filesystem — it does not set the file’s name in storage. The uploaded file is content-addressable and identified only by UUID. To place it at a specific path inside a container, pass the UUID to run’s files parameter:

{"tool": "run", "args": {
  "command": "python /app/script.py",
  "image": "img-uuid",
  "files": {"/app/script.py": "file-uuid-123"}
}}

Get Started

Inference

Observability

Post-training

Data Lab

Sandboxes

Teams & Access Management

Other Capabilities

Integrations

TL;DR

Parameters

Response

Examples

Text Content

Local File

Binary (Base64)

Using the Result

Common Mistake

See Also

​TL;DR

​Parameters

​Response

​Examples

​Text Content

​Local File

​Binary (Base64)

​Using the Result

​Common Mistake

​See Also

TL;DR

Parameters

Response

Examples

Text Content

Local File

Binary (Base64)

Using the Result

Common Mistake

See Also