Skip to navigation

Create File

Beta
Create File.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

EARLY-ACCESSstringOptional

Set to true to access beta operations via /api/v3.

Request

This endpoint expects an object.
folderIdstringRequired
namestringRequired
scratchFileIdstringRequired
filenamestringOptional
The name of the underlying file. Defaults to the ScratchFile's filename. Must not be blank, and its extension must not be blocked by the tenant's file upload settings.

Response

Created
__typenamestringOptional
archiveReasonstring or nullOptional
archivedbooleanOptional
createdAtstringOptional
creatorobjectOptional
currentVersionIdstring or nullOptional
displayIdstring or nullOptional
folderobjectOptional
idstringOptional
modifiedAtstringOptional
namestring or nullOptional
scratchFileobjectOptional
versionsstringOptionalformat: "uri"
Published versions of the File, newest first.
externalFileIdstring or nullOptionalDeprecated
Use scratchFile to access externalFileId.
filenamestring or nullOptionalDeprecated
Use scratchFile to access filename.
mimeTypestring or nullOptionalDeprecated
Use scratchFile to access mimeType.

Errors

400
File Create Request Bad Request Error
403
File Create Request Forbidden Error
404
File Create Request Not Found Error
409
File Create Request Conflict Error
429
File Create Request Too Many Requests Error
500
File Create Request Internal Server Error