Create a file
POST /api/2.0/files/{folderId}/file
Request
Creates a new file in the specified folder with the title specified in the request.
Note: If a file extension is different from DOCX/XLSX/PPTX and refers to one of the known text, spreadsheet, or presentation formats, it will be changed to DOCX/XLSX/PPTX accordingly. If the file extension is not specified or is unknown, the DOCX extension will be added to the file title.
Authorization
An API key is a token that you provide when making API calls. Include the token in a cookie parameter called asc_auth_key
.
Example: asc_auth_key=864FE52C-1C1C-469F-9308-51DAFEFE7436
.
Headers
- Accept
enum of string
Can be one of:
application/json
,text/json
,text/plain
.- Content-Type
enum of string
Can be one of:
application/json
,application/*+json
,text/json
.
Path
- folderId
integer
int32required
Body
- title
string
- templateId
one of
- .
integer
- .
string
- enableExternalExt
boolean
- formId
integer
int32
Examples
POST /api/2.0/files/463/file HTTP/1.1
Accept: application/json
Content-Length: 71
Content-Type: application/json
Host: example.com
{
"title": "markets",
"enableExternalExt": true,
"formId": 1234
}
curl --request POST \
--url https://example.com/api/2.0/files/463/file \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"title": "markets",
"enableExternalExt": true,
"formId": 1234
}'
Responses
200
New file information
- title
string
- access
one of
- .
enum of string
[None - None, ReadWrite - Read and write, Read - Read, Restrict - Restrict, Varies - Varies, Review - Review, Comment - Comment, FillForms - Fill forms, CustomFilter - Custom filter, RoomAdmin - Room admin, Editing - Editing, PowerUser - Power user]
Can be one of:
None
,ReadWrite
,Read
,Restrict
,Varies
,Review
,Comment
,FillForms
,CustomFilter
,RoomAdmin
,Editing
,PowerUser
.- .
enum of integer
[0 - None, 1 - Read and write, 2 - Read, 3 - Restrict, 4 - Varies, 5 - Review, 6 - Comment, 7 - Fill forms, 8 - Custom filter, 9 - Room admin, 10 - Editing, 11 - Power user]
Can be one of:
0
,1
,2
,3
,4
,5
,6
,7
,8
,9
,10
,11
.
- shared
boolean
- created
object
- utcTime
string
date-time - timeZoneOffset
string
date-span
- createdBy
object
- id
string
uuid - displayName
string
- title
string
- avatar
string
- avatarOriginal
string
- avatarMax
string
- avatarMedium
string
- avatarSmall
string
- profileUrl
string
- hasAvatar
boolean
- isAnonim
boolean
- updated
object
- utcTime
string
date-time - timeZoneOffset
string
date-span
- autoDelete
object
- utcTime
string
date-time - timeZoneOffset
string
date-span
- rootFolderType
one of
- .
enum of string
[DEFAULT - Default, COMMON - Coomon, BUNCH - Bunch, TRASH - Trash, USER - User, SHARE - Share, Projects - Projects, Favorites - Favourites, Recent - Recent, Templates - Templates, Privacy - Privacy, VirtualRooms - Virtual rooms, FillingFormsRoom - Filling forms room, EditingRoom - Editing room, CustomRoom - Custom room, Archive - Archive, ThirdpartyBackup - Thirdparty backup, PublicRoom - Public room, ReadyFormFolder - Ready form folder, InProcessFormFolder - In process form folder, FormFillingFolderDone - Form filling folder done, FormFillingFolderInProgress - Form filling folder in progress]
Can be one of:
DEFAULT
,COMMON
,BUNCH
,TRASH
,USER
,SHARE
,Projects
,Favorites
,Recent
,Templates
,Privacy
,VirtualRooms
,FillingFormsRoom
,EditingRoom
,CustomRoom
,Archive
,ThirdpartyBackup
,PublicRoom
,ReadyFormFolder
,InProcessFormFolder
,FormFillingFolderDone
,FormFillingFolderInProgress
.- .
enum of integer
[0 - Default, 1 - Coomon, 2 - Bunch, 3 - Trash, 5 - User, 6 - Share, 8 - Projects, 10 - Favourites, 11 - Recent, 12 - Templates, 13 - Privacy, 14 - Virtual rooms, 15 - Filling forms room, 16 - Editing room, 19 - Custom room, 20 - Archive, 21 - Thirdparty backup, 22 - Public room, 25 - Ready form folder, 26 - In process form folder, 27 - Form filling folder done, 28 - Form filling folder in progress]
Can be one of:
0
,1
,2
,3
,5
,6
,8
,10
,11
,12
,13
,14
,15
,16
,19
,20
,21
,22
,25
,26
,27
,28
.
- parentRoomType
one of
- .
enum of string
[DEFAULT - Default, COMMON - Coomon, BUNCH - Bunch, TRASH - Trash, USER - User, SHARE - Share, Projects - Projects, Favorites - Favourites, Recent - Recent, Templates - Templates, Privacy - Privacy, VirtualRooms - Virtual rooms, FillingFormsRoom - Filling forms room, EditingRoom - Editing room, CustomRoom - Custom room, Archive - Archive, ThirdpartyBackup - Thirdparty backup, PublicRoom - Public room, ReadyFormFolder - Ready form folder, InProcessFormFolder - In process form folder, FormFillingFolderDone - Form filling folder done, FormFillingFolderInProgress - Form filling folder in progress]
Can be one of:
DEFAULT
,COMMON
,BUNCH
,TRASH
,USER
,SHARE
,Projects
,Favorites
,Recent
,Templates
,Privacy
,VirtualRooms
,FillingFormsRoom
,EditingRoom
,CustomRoom
,Archive
,ThirdpartyBackup
,PublicRoom
,ReadyFormFolder
,InProcessFormFolder
,FormFillingFolderDone
,FormFillingFolderInProgress
.- .
enum of integer
[0 - Default, 1 - Coomon, 2 - Bunch, 3 - Trash, 5 - User, 6 - Share, 8 - Projects, 10 - Favourites, 11 - Recent, 12 - Templates, 13 - Privacy, 14 - Virtual rooms, 15 - Filling forms room, 16 - Editing room, 19 - Custom room, 20 - Archive, 21 - Thirdparty backup, 22 - Public room, 25 - Ready form folder, 26 - In process form folder, 27 - Form filling folder done, 28 - Form filling folder in progress]
Can be one of:
0
,1
,2
,3
,5
,6
,8
,10
,11
,12
,13
,14
,15
,16
,19
,20
,21
,22
,25
,26
,27
,28
.
- updatedBy
object
- id
string
uuid - displayName
string
- title
string
- avatar
string
- avatarOriginal
string
- avatarMax
string
- avatarMedium
string
- avatarSmall
string
- profileUrl
string
- hasAvatar
boolean
- isAnonim
boolean
- providerItem
boolean
- providerKey
string
- providerId
integer
int32 - order
string
- id
integer
int32 - rootFolderId
integer
int32 - originId
integer
int32 - originRoomId
integer
int32 - originTitle
string
- originRoomTitle
string
- canShare
boolean
- security
object
- Read
boolean
- Comment
boolean
- FillForms
boolean
- Review
boolean
- Create
boolean
- Edit
boolean
- Delete
boolean
- CustomFilter
boolean
- EditRoom
boolean
- Rename
boolean
- ReadHistory
boolean
- Lock
boolean
- EditHistory
boolean
- CopyTo
boolean
- Copy
boolean
- MoveTo
boolean
- Move
boolean
- Pin
boolean
- Mute
boolean
- EditAccess
boolean
- Duplicate
boolean
- SubmitToFormGallery
boolean
- Download
boolean
- Convert
boolean
- CopySharedLink
boolean
- ReadLinks
boolean
- Reconnect
boolean
- CreateRoomFrom
boolean
- EditForm
boolean
- CopyLink
boolean
- Embed
boolean
- folderId
integer
int32 - version
integer
int32 - versionGroup
integer
int32 - contentLength
string
- pureContentLength
integer
int64 - fileStatus
one of
- .
enum of string
[None - None, IsEditing - Is editing, IsNew - Is new, IsConverting - Is converting, IsOriginal - Is original, IsEditingAlone - Is editing alone, IsFavorite - Is favorite, IsTemplate - Is template, IsFillFormDraft - Is fill form draft]
Can be one of:
None
,IsEditing
,IsNew
,IsConverting
,IsOriginal
,IsEditingAlone
,IsFavorite
,IsTemplate
,IsFillFormDraft
.- .
enum of integer
[0 - None, 1 - Is editing, 2 - Is new, 4 - Is converting, 8 - Is original, 16 - Is editing alone, 32 - Is favorite, 64 - Is template, 128 - Is fill form draft]
Can be one of:
0
,1
,2
,4
,8
,16
,32
,64
,128
.
- mute
boolean
- viewUrl
string
uri - webUrl
string
uri - fileType
one of
- .
enum of string
[Unknown - Unknown, Archive - Archive, Video - Video, Audio - Audio, Image - Image, Spreadsheet - Spreadsheet, Presentation - Presentation, Document - Document, Pdf - Pdf]
Can be one of:
Unknown
,Archive
,Video
,Audio
,Image
,Spreadsheet
,Presentation
,Document
,Pdf
.- .
enum of integer
[0 - Unknown, 1 - Archive, 2 - Video, 3 - Audio, 4 - Image, 5 - Spreadsheet, 6 - Presentation, 7 - Document, 10 - Pdf]
Can be one of:
0
,1
,2
,3
,4
,5
,6
,7
,10
.
- fileExst
string
- comment
string
- encrypted
boolean
- thumbnailUrl
string
uri - thumbnailStatus
one of
- .
enum of string
[Waiting - Waiting, Created - Created, Error - Error, NotRequired - Not required, Creating - Creating]
Can be one of:
Waiting
,Created
,Error
,NotRequired
,Creating
.- .
enum of integer
[0 - Waiting, 1 - Created, 2 - Error, 3 - Not required, 4 - Creating]
Can be one of:
0
,1
,2
,3
,4
.
- locked
boolean
- lockedBy
string
- denyDownload
boolean
- hasDraft
boolean
- isForm
boolean
- startFilling
boolean
- inProcessFolderId
integer
int32 - inProcessFolderTitle
string
- draftLocation
object
- folderId
integer
int32 - folderTitle
string
- fileId
integer
int32 - fileTitle
string
- denySharing
boolean
- viewAccessibility
object
- ImageView
boolean
- MediaView
boolean
- WebView
boolean
- WebEdit
boolean
- WebReview
boolean
- WebCustomFilterEditing
boolean
- WebRestrictedEditing
boolean
- WebComment
boolean
- CoAuhtoring
boolean
- CanConvert
boolean
- MustConvert
boolean
- availableExternalRights
object
- requestToken
string
- lastOpened
object
- utcTime
string
date-time - timeZoneOffset
string
date-span
- fileEntryType
enum of integer
int32 Can be one of:
1
,2
.
401
Unauthorized
403
Forbidden