- URL:https://<uploads-url>/upload
(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
Uploads a new item to the server. Once the operation is completed successfully, the JSON structure of the uploaded item is returned.
Request parameters
| Parameter | Details |
|---|---|
| itemFile | The file to be uploaded, processed as a multipart post file. |
| description (Optional) | An description for the uploaded item. |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for upload:
POST /webadaptor/admin/uploads/upload HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boudnary=----boundary
Content-Length: []
------boundary
Content-Disposition: form-data; name="itemFile"; filename=""
Content-Type: application/octet-stream
FireWeatherWatch.kmz
------boundary
Content-Disposition: form-data; name="description"
------boundary
Content-Disposition: form-data; name="f"
pjson
------boundary
Content-Disposition: form-data; name="csrfPreventToken"
aArYcVTHhrDvc-V6RghZUNx-tKjzAgoTU6cSB0VZEdzRRp9Drph_gBBSiwInP-5iG75J3jPhMGhP0PXfkyJYI9Fuicb2mERvj_GxlPeVcmUGhmDk2Y1_0X8RLjOlJBNhs5DozQ2N0Un1l4siWwQ5SBUd6UZE6YF1lMQYCQqTXxwpzkLC6A_bAKMz-cHARp9N,https://machine.domain.com/webadaptor/admin
------boundary--JSON Response syntax
{
"status": "success",
"item": "if4582d33-f10a-41fe-85bc-cf2e2880c46e"
}