FILES

Upload a file

POST/v1/files/uploadsscope: files.write

Step 1: create an upload with the name, size and type. We return a signed PUT URL valid for one hour.

Step 2: PUT the bytes to that URL, then call POST /v1/files/{id}/complete.

Files over 100 MB get a multipart upload: PUT each part and send the list of partNumber and etag on complete.

Parameters

namestringrequired

File name.

sizeintegerrequired

Size in bytes.

mimestring

Content type.

folderIdstring

Target folder (default root).

conflictrename | replace | fail

What to do on a name conflict. replace creates a new version.

Errors

400 file_too_large400 quota_exceeded409 name_conflict