Upload a file
POST /api/2.0/files/{folderId}/uploadRequest
Uploads a file specified in the request to the selected folder by single file uploading or standart multipart/form-data method.
Note: You can upload files in two different ways:
- Using single file upload. You should set the Content-Type and Content-Disposition headers to specify a file name and content type, and send the file to the request body.
- Using standart multipart/form-data method.
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
integerformat: int32required
Body
- file
stringformat: binary - contentType
object - boundary
string - charSet
string - mediaType
string - name
string - parameters
array of unknown
- contentDisposition
object - dispositionType
string - parameters
array of unknown - fileName
string - creationDate
stringformat: date-time - modificationDate
stringformat: date-time - inline
boolean - readDate
stringformat: date-time - size
integerformat: int64
- files
array of unknown - createNewIfExist
boolean - storeOriginalFileFlag
boolean - keepConvertStatus
boolean - stream
stringformat: binary
Examples
POST /api/2.0/files/1573/upload HTTP/1.1
Accept: application/json
Content-Length: 877
Content-Type: application/json
Host: example.com
{
"contentType": {
"boundary": "some text",
"charSet": "some text",
"mediaType": "some text",
"name": "Savannah Anderson",
"parameters": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
]
},
"contentDisposition": {
"dispositionType": "some text",
"parameters": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
],
"fileName": "some text",
"creationDate": "2008-04-10T06:30:00.0000000+04:00",
"modificationDate": "2008-04-10T06:30:00.0000000+04:00",
"inline": true,
"readDate": "2008-04-10T06:30:00.0000000+04:00",
"size": 1234
},
"files": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
],
"createNewIfExist": true,
"storeOriginalFileFlag": true,
"keepConvertStatus": true
}curl --request POST \
--url https://example.com/api/2.0/files/1573/upload \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"contentType": {
"boundary": "some text",
"charSet": "some text",
"mediaType": "some text",
"name": "Savannah Anderson",
"parameters": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
]
},
"contentDisposition": {
"dispositionType": "some text",
"parameters": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
],
"fileName": "some text",
"creationDate": "2008-04-10T06:30:00.0000000+04:00",
"modificationDate": "2008-04-10T06:30:00.0000000+04:00",
"inline": true,
"readDate": "2008-04-10T06:30:00.0000000+04:00",
"size": 1234
},
"files": [
{
"int": 1234,
"string": "some text",
"boolean": true
}
],
"createNewIfExist": true,
"storeOriginalFileFlag": true,
"keepConvertStatus": true
}'Responses
200
Inserted file
401
Unauthorized
403
Forbidden