Drive > Files > File/Directory > Upload > Session

Batch : start sessions

This call creates one or more upload session(s). <br/> Batch of upload sessions allows you to start multiple sessions for multiples files in one request. Each input request is cast in the same way of <a href="../start">upload/session/start</a>. <br/><br/><note> The maximum size per chunk request is 1GB. </note> <br/><note> When a session is started, it can be used for a maximum of 4 hours. </note> <br/><note> To upload a chunk, you must use the ‘upload_url’ returned from the session opening call : <a href="../start">upload/session/start</a>. </note> <br/><note> Finally, when all the data have been sent you should call <a href="../{session_token}/finish">upload/session/{session_token}/finish</a> or (<a href="./finish">upload/session/batch/finish</a>) to close the session(s) and save all the files in kDrive. </note> <br/><note> The batch cannot exceed 1,000 sessions. </note> <br/><note> If your file is small (<100MB) we recommend you to use the <a href="../../">direct upload route</a> to avoid multiple requests. </note>

post/3/drive/{drive_id}/upload/session/batch/start

Path parameters

drive_idinteger required

Drive identifier

Query parameters

withstring

Optional : Allows loading additional data about a resource, which may include related resources.

Request body

Example request

{
  "*": {
    "If-Match": "9e22d98e554fe8df",
    "conflict": "version",
    "directory_path": "/Directory/SubDirectory",
    "file_name": "file.txt"
  }
}

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

data91ac10ffUploadSessionFeedback[] — unresolved $ref

Changes

No recorded changes to this endpoint across all 1 revision of this API.