Skip to main content
POST
Upload file

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

project_id
string<uuid>

Optional project ID for project-scoped sandbox files

task_id
string<uuid>

Optional isolated task ID for task-scoped sandbox files

sandbox
string

Route file operations to a specific sandbox: cloud, a self-hosted sandbox UUID from the sandbox list, or an unambiguous display name / hostname. UUID values are always interpreted as IDs, never names. Prefer IDs because names can change. When omitted, the Neo-managed cloud sandbox is used. An unavailable or ambiguous selection returns an error and never selects another host.

Body

multipart/form-data
file
file
required

File to upload

file_key
string
required

Required destination file key

chat_id
string

Associate file with chat ID

Response

File uploaded

error
string
file_url
string

Signed URL to access the file

key
string

File key for operations (delete, move, patch, replace)

size
integer

File size in bytes

success
boolean
url_expire_in_seconds
integer