v2

latestOpenAPI 3.1.02026-08-014610794.4 KB
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/v1/files/{file_path}

Path parameters

file_pathstring required

Query parameters

strictboolean

Response

File uploaded successfully

filePathstring required
contentTypestring required