v2
latestOpenAPI 3.1.02026-08-014610794.4 KBfiles
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