OPopen-eo
File Storage

Upload a file to the workspace

Changed on

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}

Request

  • Base URL
    https://openeo.example/api/v1
  • Auth
    HTTP bearer

Request body application/octet-stream

string binary required

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"
}

Changes

  • 14b9824d2788Revision changes
    • info

      the response's property pattern was changed from ^[^/ \:'"][^ \:'"]*$ to ^[^/\r\n\t\\:'"][^\r\n\t\\:'"]*$ for the status

  • a5a4894f6ec8Revision changes
    • info

      the response's property pattern was changed from ^[^/\r\n\t\\:'"][^\r\n\t\\:'"]*$ to ^[^/ \:'"][^ \:'"]*$ for the status