v1

latestOpenAPI 3.0.2Apache 2.02026-07-1739106293.5 KB
File Storage

Upload a file to the workspace

Uploads a new file to the given path or updates an existing file if a file at the path exists.

Folders are created once required by a file upload. Empty folders can not be created.

put/files/{path}

Response

The file has been uploaded successfully.

pathstring required

Path of the file, relative to the root directory of the user's server-side workspace. MUST NOT start with a slash / and MUST NOT be url-encoded.

The Windows-style path name component separator \ is not supported, always use / instead.

Note: The pattern only specifies a minimal subset of invalid characters. The back-ends MAY enforce additional restrictions depending on their OS/environment.

sizeinteger

File size in bytes.

modifiedstring date-time

Date and time the file has lastly been modified, formatted as a RFC 3339 date-time.

Example response

{
  "path": "folder/file.txt",
  "size": 1024,
  "modified": "2018-01-03T10:55:29Z"
}