- URL:
- https://<root>/uploads/upload
- Methods:
- POST
- Required Capability:
- Access allowed with any authorized privilege
- Version Introduced:
- 10.1
Description
The upload operation 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 | 
|---|---|
| 
 | The file to be uploaded, processed as a multipart post file. | 
| 
 (Optional) | An description for the uploaded item. | 
| 
 | The response format. The default response format is  Values:  | 
Example usage
The following is a sample POST request for the upload operation:
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"
}