Direct uploads

Prepare a OneDrive or SharePoint upload for host file transport

Changed on

Like createMicrosoft365DriveUploadSession, but Microsoft's session URL stays in OpenWork Cloud: the host sends the file in chunks to the relay route with the returned uploadToken. Saves through OpenWork Cloud are limited to the pull size limit.

post/v1/direct-uploads/microsoft-365/drive-upload-sessions

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/direct-uploads/microsoft-365/drive-upload-sessions
  • Auth: HTTP bearer

Request body

driveIdstring

The file's driveId from a search, folder or link result. Omit for the member's own OneDrive.

itemIdstring

Replace this existing file's content. It keeps its link and sharing; the previous version stays in its version history.

baseRevisionstring

Required with itemId: the eTag your copy was downloaded from. Refused with drive_conflict when the file changed since; download it again and reapply the edits, or save a new file.

folderIdstring

New files only: the folder to create the file in; omit for the top of the drive.

namestring

New files only: the file name.

conflictBehavior'fail' | 'rename'

New files only: fail, or let Microsoft rename the file when the name is taken.

sizeinteger required
connectionIdstring

Selected Microsoft 365 connection; omit for the default. Unavailable selections never fall back to another account.

Response

Opaque upload token; file not yet uploaded.

oktrue required
uploadTokenstring required

Opaque token for the relay route; Microsoft's session URL stays in OpenWork Cloud.

sizeinteger required
chunkSize10485760 required
expiresAtstring date-time required

Changes

  • c93387179b31Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      response property anyOf[InvalidRequestError]/details/items/path/items/ list-of-types was narrowed by removing types number from media type application/json of response 400

    • info

      response property anyOf[subschema #2]/currentRevision list-of-types was narrowed by removing types null from media type application/json of response 409

    • info

      response property anyOf[subschema #2]/modifiedTime list-of-types was narrowed by removing types null from media type application/json of response 409

    • info

      response property replaces/previousRevision list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      the response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

  • 3e38eb291e52Revision changes
    • info

      endpoint added