How do you upload a document with a REST API call?

Jeff Wogan

Assuming it's possible, is there an example of uploading a file using a REST API call? The closest I've found is the DEMO, but that is using Apache Cordova to build a mobile app.

I would image using an AJAX call to /api/v1/nodes with a method of POST and a content-type of "multipart/form-data". But what parameter holds the actual file?

Jeff Wogan

To answer my own question, look here for an AJAX solution.

For a ColdFusion Server Side solution, try this:

<!--- Login --->
<cfhttp method="POST" url="http(s)://<machine name>/<CS service name>/<CS CGI>/api/v1/auth"  result="response">
    <cfhttpparam type="header" name="content-type" value="application/x-www-form-urlencoded">
    <cfhttpparam type="body" value="username={username}&password={password}">
</cfhttp>

<cfif response.ResponseHeader.Status_Code is "200">
    <cfset cs=StructNew()>
    <cfset cs=deserializeJSON(response.Filecontent)>
    <cfset otcsticket=cs.TICKET>
</cfif>

To upload a file, try this:

<cfhttp method="POST" url="http(s)://<machine name>/<CS service name>/<CS CGI>/api/v1/nodes">
    <cfhttpparam type="header" name="otcsticket" value="#otcsticket#>
    <cfhttpparam type="formfield" name="type" value="144">
    <cfhttpparam type="formfield" name="parent_id" value="{parent_id}">
    <cfhttpparam type="formfield" name="name" value="{filename without extention}">
    <cfhttpparam type="file" name="file" file="{absolution path}\{filename}.{ext}">
</cfhttp>

To create a folder, try this:

<cfhttp method="POST" url="http(s)://<machine name>/<CS service name>/<CS CGI>/api/v1/nodes">
    <cfhttpparam type="header" name="otcsticket" value="#otcsticket#>
    <cfhttpparam type="header" name="content-type" value="application/x-www-form-urlencoded">
    <cfhttpparam type="body" value="type=0&parent_id={parent_id}&name={new folder name}">
</cfhttp>