| Name | upload | |
| Description | Raw upload service, mainly for XHR based requests or requests from non-browser clients | |
| Accessible Via | /api/service/upload | |
| HTTP GET | No | |
| HTTP POST | Yes | |
| Special Headers | X-Metaweb-Request : any alnum value | |
| Login Required | Yes | |
| Required Arguments | file : file uploaded as part of request body | |
| Optional Arguments | content_type : valid IANA mime-type per RFC2045 section 5.1 use_permission_of : type id/guid for object whose permission is the same as the desired permission on uploaded object | |
| Extra Arguments Ignored | Yes | |
| Response Format | application/json | |
| Notes | Rules :
The service also creates and executes a MQL query to register the content object in the graph and associate it with an existing document or newly created document as the case may be. Sample Response : { For additional information on using the callback parameter to generate a JSONP response, or using onsucceed and onfail to redirect to a URI template, see Common API Query Parameters. |