RESTAPI Upload

This can be used to upload a single file as the POST body, or multiple files in a mime document. This is an example of uploading multiple files using the curl command:

    curl -k -u mo -X POST -F "file=@/temp/file.xml" -F "file=@/temp/file2.xml" "https://spiffy:52311/api/upload"

Multiple-file POST body example: You can include more than one file in a single post using the following syntax for each file:

    Content-Length: 1136
    Content-Type: multipart/form-data; boundary=----------------------------27beaea68af8

    ------------------------------27beaea68af8
    Content-Disposition: form-data; name="file"; filename="file.data"
    Content-Type: application/octet-stream

    file data goes here
    ------------------------------27beaea68af8--

Single-file POST body example: For uploading a single file you can specify the filename in the content-disposition header and send the file as the body, for example:

    Content-Disposition: attachment; filename="file.xml"

To add files to a custom site, use the site/{site type}/{site name}/files resource in the Site resource page.

Response: BESAPI showing the name, url, sha1, and size of file.

Sets a new reference to the given file. As with action/{action id}/stop, no actual data is posted. Only the URL is needed. In the URL, you can specify whether or not the reference can be seen by others. For example:

    upload/514e37eda5a64ca9872f4972618eaf41e981e8e9/icon.bmp?private=1

means that only you and the MO can see that reference in GET uploads/{filelocation}/references and GET uploads/{filelocation}/reference/{ID}. If private is not specified, the default is 0 (not private).