Upload File

curl --request PUT \
  --url https://api.example.com/api/v1/files/{file_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

{
  "filePath": "<string>",
  "contentType": "<string>"
}

Files

Upload File

Upload a file (max. 5 GB) to the specified path.

Specify the Content-Type header for accurate file type handling.
If Content-Type is omitted, the system will attempt to infer it.
For workspace-specific uploads, use path: workspaces/{workspace_id}/...
If a file with the same file path already exists, it will be overwritten.
If there are unsupported characters in the file path, they will be removed or replaced.
If the file path is longer than 1024 characters, the file path will be shortened starting from the end.
Set strict=true to fail the request if the file path would be modified during sanitization (e.g., if the file path contains unsupported characters or is too long).

PUT

api

files

{file_path}

Upload File

curl --request PUT \
  --url https://api.example.com/api/v1/files/{file_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

{
  "filePath": "<string>",
  "contentType": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

file_path

string

required

Query Parameters

strict

boolean

default:false

Body

multipart/form-data

file

required

Response

File uploaded successfully

filePath

string

required

contentType

string

required

Set Signed Cookies Complete

⌘I

Python Vision Agent

AskUI Suite

Workspace Services API

Upload File

Authorizations

Path Parameters

Query Parameters

Body

Response