{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"A new API is now available","type":"text"}]},{"type":"paragraph","content":[{"text":"This page documents IntelligenceBank's legacy API referred to as v2. Please use instead the new","type":"text"},{"text":" API version","type":"text","marks":[{"type":"strong"}]},{"text":", referred to as","type":"text"},{"text":" v3","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"},{"text":"You can access the v3 API documentation at","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"https://apidoc.intelligencebank.com","type":"text","marks":[{"type":"link","attrs":{"href":"https://apidoc.intelligencebank.com"}}]}]}]},{"type":"rule"},{"type":"expand","attrs":{"title":"Table of Contents"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b1fbeff8-83b7-4496-bc91-3e65005cc0ff"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"37477d2b-cba3-4c99-8f79-baf3275b18f0"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This service provides the ability to retrieve, add and modify digital assets that reside on an IntelligenceBank platform instance.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"RFC2119 Words","type":"text"}]},{"type":"paragraph","content":[{"text":"The key words \"MUST\",\"MUST NOT\", \"REQUIRED\", \"SHALL\", \"SHALL NOT\", \"SHOULD\", \"SHOULD NOT\", \"RECOMMENDED\", \"MAY\" and \"OPTIONAL\" in this document are to be interpreted as described in RFP2119.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Media Type Support","type":"text"}]},{"type":"paragraph","content":[{"text":"All server response bodies SHOULD be returned using the JSON Media Type. All client request bodies SHOULD be sent using the application/x-www-form-urlencoded Form Media Type, or the multipart/form Media Type as appropriate.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Product Key","type":"text"}]},{"type":"paragraph","content":[{"text":"All calls can have a product key parameter appended to the URL as p60=","type":"text"},{"text":"KEYVALUE.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"It allows to track the source of calls in the platform's Usage Reporting.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"URLs and Operations","type":"text"}]},{"type":"paragraph","content":[{"text":"All URLs share a common base of","type":"text"}]},{"type":"paragraph","content":[{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]}]},{"type":"paragraph","content":[{"text":"where XXXXX is the ","type":"text"},{"text":"API server subdomain","type":"text","marks":[{"type":"strong"}]},{"text":" assigned to a client. You can use the ","type":"text"},{"text":"Request Client API URL ","type":"text","marks":[{"type":"strong"}]},{"text":"call to retrieve the subdomain applicable to your platform domain.","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is a list of the endpoint URLs and the operations they perform","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/login","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/login","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST using the Login Payload and returns the Login Response ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/reset","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/reset ","type":"text","marks":[{"type":"strong"}]},{"text":"URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST using the Reset Payload and returns the No Content Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/resources","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/resources","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" GET using the Root Folder Request and returns the Folder Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" GET using the Folder Request and returns the Folder Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" GET using the Resource Request and returns the resource file or file size estimate","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" POST using the Create Folder Payload and returns the FolderResponse ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" POST using the Create Resource Payload and returns the Resource Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" PUT using the Update Folder Payload and returns the FolderResponse","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" PUT using the Update Resource Payload and returns the Resource Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" DELETE using the Delete Folder Request and returns a No Content Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" DELETE using the Delete Resource Request and returns a No Content Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/icon","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/icon","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" GET using the Icon Request and returns the icon file ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/comments","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/comments","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET with the Comment Request and returns the Comment Response","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST with the Comment Payload and returns the No Content Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/sync","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/sync","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST with the Sync Payload and returns the Sync Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/search","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/search","type":"text","marks":[{"type":"strong"}]},{"text":" URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET with the Search Request and returns the Search Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/downloadpresets","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"/downloadpresets ","type":"text","marks":[{"type":"strong"}]},{"text":"URL supports the following HTTP methods","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" GET using the Download Preset Request and returns the Download Preset Response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requests and Payloads","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is a list of query strings and payloads that can be sent from the client to the server along with a list of common server responses.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Login","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p70=joe.blow@","type":"text","marks":[{"type":"em"}]},{"text":"test.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://test.com"}}]},{"text":"&p80=mypassword&p90=","type":"text","marks":[{"type":"em"}]},{"text":"test.intelligencebank.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://test.intelligencebank.com"}}]}]},{"type":"paragraph","content":[{"text":"would request a login to the ","type":"text"},{"text":"test.intelligencebank.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://test.intelligencebank.com"}}]},{"text":" site with the user ","type":"text"},{"text":"joe.blow@test.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:joe.blow@test.com"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is a simple key/value pairs. The client MUST use POST to send this payload to the Login URL. You SHOULD use the following header:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Login URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/login","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Login Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Reset Password","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p70=joe.blow@","type":"text","marks":[{"type":"em"}]},{"text":"test.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://test.com"}}]},{"text":"&p90=","type":"text","marks":[{"type":"em"}]},{"text":"test.intelligencebank.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://test.intelligencebank.com"}}]}]},{"type":"paragraph","content":[{"text":"would request the server to send a password reset email to be sent to ","type":"text"},{"text":"joe.blow@test.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:joe.blow@test.com"}}]},{"text":". If the user is valid then an email will be sent to that address.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is simple key/value pairs. The client MUST use POST to send this payload to the Reset URL. You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Reset URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/reset","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the No Content Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Client API URL","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that this call uses a different API.","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.","type":"text","marks":[{"type":"em"}]},{"text":"intelligencebank.com/v1/auth/app/getYapiAddress","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/v1/auth/app/getYapiAddress"}}]}]},{"type":"paragraph","content":[{"text":"Return example:","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"SID\":\"eef24c07ebd40fafbb6ab216aa0d1ade\",\"content\":\"https:\\/\\/","type":"text","marks":[{"type":"em"}]},{"text":"apiau.intelligencebank.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://apiau.intelligencebank.com"}}]},{"text":"\"}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"In this case, URL to use for subsequent API calls is ","type":"text"},{"text":"https://apiau.intelligencebank.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://apiau.intelligencebank.com"}}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Browser Login (For SSO Users)","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that this call uses a different API. It enables the user to be ","type":"text"},{"text":"authenticated by login to IntelligenceBank via their browser","type":"text","marks":[{"type":"strong"}]},{"text":". This is useful for Single Sign On users to login into third-party applications using the IntelligenceBank API.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"STEP 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"https://.","type":"text","marks":[{"type":"em"}]},{"text":"intelligencebank.com/v1/auth/app/token","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/v1/auth/app/token"}}]}]},{"type":"paragraph","content":[{"text":"Example response:","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"SID\":\"eef24c07ebd40fafbb6ab216aa0d1ade\",\"content\":\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":"VeZEZR9ee","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff6600"}},{"type":"em"}]},{"text":"\"}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"STEP 2","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Use the content value returned (","type":"text"},{"text":"in orange","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff6600"}}]},{"text":"), i.e. token, to open login url in browser:","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.","type":"text","marks":[{"type":"em"}]},{"text":"intelligencebank.com/auth/?login=1&token=","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/auth/?login=1&token=VeZEZR9ee"}}]},{"text":"VeZEZR9ee","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff6600"}},{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/auth/?login=1&token=VeZEZR9ee"}}]}]},{"type":"paragraph","content":[{"text":"STEP 3","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"After login is done on the web, use the token to call the API and get the login session info:","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.","type":"text","marks":[{"type":"em"}]},{"text":"intelligencebank.com/v1/auth/app/info?token=","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/v1/auth/app/info?token=VeZEZR9ee"}}]},{"text":"VeZEZR9ee","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff6600"}},{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com/v1/auth/app/info?token=VeZEZR9ee"}}]}]},{"type":"paragraph","content":[{"text":"The return content has 2 parts:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'session' contains the session info, use the ","type":"text"},{"text":"sid","type":"text","marks":[{"type":"em"}]},{"text":" value inside as the login proof, the loginTime is the time when this session was activated. The time out period will be based on this.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'info' contains the same info returned with the standard Login API call.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note, this token is a one-time token, once you successfully received the login response info, the token will be erased on the server (for security and performance reasons).","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Login response:","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"SID\":\"eef24c07ebd40fafbb6ab216aa0d1ade\",\"content\":{\"session\":","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"{\"sid\":\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":"eef24c07ebd40fafbb6ab216aa0d1ade","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff6600"}},{"type":"em"}]},{"text":"\",\"userUuid\":\"4717c0b468e7a1d00872f56c81164ec1\",\"originalUserUuid\":null,\"loginTime\":1538631769}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":",\"info\":{\"clientname\":\"value\",\"clientuuid\":\"d78d15bb480cf9ec53f4dfed7076c740\",\"apikey\":\"","type":"text","marks":[{"type":"em"}]},{"text":"4a0658df9084f078d0cbc506e0f29b57","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"em"}]},{"text":"\",\"logintimeoutperiod\":120,\"adminemail\":\"sample@","type":"text","marks":[{"type":"em"}]},{"text":"intelligencebank.com","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://intelligencebank.com"}}]},{"text":"\",\"passwordexpiryperiod\":null,\"userverificationperiod\":null,\"offlineexpiryperiod\":120,\"annotations\":\"Advanced\",\"comments\":\"1\",\"passwordexpired\":null,\"emailexpired\":null,\"versions\":\"1\",\"firstname\":\"henry\",\"lastname\":\"jiang\",\"useruuid\":\"4717c0b468e7a1d00872f56c81164ec1\",\"thumbnail\":\"value\",\"foldericon\":\"72c7319b204bef3475c9c696c625e083\",\"rowsOnPage\":\"50\",\"colourPrimary\":\"#100F0F\",\"colourPrimaryText\":\"#B1A3A3\",\"colourSecondary\":\"#F4600C\",\"colourSecondaryText\":\"#5092E5\",\"colourHighlight\":\"#78B7D4\",\"enableMasterSync\":\"0\",\"enableCustomBranding\":\"1\",\"enableAnnotations\":\"1\",\"enableImageReader\":\"1\",\"enableAppOpenIn\":\"1\",\"isResourceMainAdmin\":true,\"toolNameMapping\":{\"resource\":","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"STEP 4","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You will then need to construct the _aid value which is to be set as a cookie in the header of the subsequent calls as follow:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"apikey","type":"text","marks":[{"type":"textColor","attrs":{"color":"#339966"}},{"type":"em"}]},{"text":"_","type":"text","marks":[{"type":"em"}]},{"text":"sid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0000ff"}},{"type":"em"}]},{"text":"_","type":"text","marks":[{"type":"em"}]},{"text":"productkey","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800080"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"If you do not have a product key (also referred to as p60), use default as a value.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example _aid:","type":"text"}]},{"type":"paragraph","content":[{"text":"4a0658df9084f078d0cbc506e0f29b57","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"em"}]},{"text":"_","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":"eef24c07ebd40fafbb6ab216aa0d1ade","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0000ff"}},{"type":"em"}]},{"text":"_","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":"default","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800080"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Warning, DO NOT use the first level SID, but always use the \"sid\" value returned inside \"session\".","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Root Folder List","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request the contents of the root folder. This will contain metadata for all the folders with the root folder and will allow the client to navigate the underlying folder structure.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Resources URL. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Folder Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Folder Info","type":"text"}]},{"type":"paragraph","content":[{"text":"This call allows to request and retrieve details of sub-folders and number of files about one or multiple folders. If folders have a lot of files (e.g. 1000+), it is advised to make this call first to retrieve the count of files so that subsequent folder content requests can be paginated accordingly (see below).","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&folderlist={folder uuids separated by commas}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Folder Content","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&folderuuid={folder uuid}&skip={starting position}&limit={number of resources to return}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"If the limit parameter is included in the request then the number of resources returned will be the value of the limit parameter, starting from the first resource if there is no skip value present, or from the value of the skip parameter if it is present.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the skip parameter is included in the request and the limit parameter is not then the resources returned will be those starting from the skip value and ending at the last resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"The skip value is zero indexed based i.e. the first resource resides at skip=0. If the skip parameter is not included in the request then the starting point will be as if a skip value of 0 was included. If the skip value is larger than the number of resources in the folder, then no resource element will be returned.","type":"text"}]},{"type":"paragraph","content":[{"text":"The maximum number of results that can be returned at once is 1000.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Resources URL. The client MUST include the p10, p20 and folderuuid parameters. The client MAY include the skip and/or the limit parameters. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Folder Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&folderuuid=hg3v23ghj4hb34hhjhjg34ezrezrezezrez","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"would request the contents of the folder with that folderuuid. The response will contain metadata for all the folders and resources within the folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&folderuuid=hg3v23ghj4hb34hhjhjg34ezrezrezezrez&skip=0&limit=50","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request the contents of the folder with that folderuuid. The response will contain metadata for all the folders and the first 50 resources within the folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&folderuuid=hg3v23ghj4hb34hhjhjg34ezrezrezezrez&skip=50&limit=50","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request the contents of the folder with that folderuuid. The response will contain metadata for all the folders and the next 50 resources within the folder.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete Folder Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&folderuuid={folder uuid}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&folderuuid=hg3v23ghj4hb34hhjhjg34","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to delete the folder with that folderuuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Resources URL. The client MUST use DELETE when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the No Content Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create Folder","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"name=Images&parent=hjsdhsd5sddsjhd675ddfsfddsf","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to create the folder called Images within the parent folder with that uuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is simple key/value pairs. The client MUST use POST to send this payload to the Resources URL. You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Folder Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Update Folder","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}&folderuuid=hg3v23ghj4hb34hhjhjg34dssf","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"name=Archived%20Images","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to update the name of the folder with that uuid to the new value \"Archived Images\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is simple key/value pairs. The client MUST use PUT to send this payload to the Resources URL. You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Folder Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Resource Request","type":"text"}]},{"type":"paragraph","content":[{"text":"Context","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"User wants to download a file.","type":"text"}]},{"type":"paragraph","content":[{"text":"URL","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"https://api.intelligencebank.com/webapp/1.0/resources","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://api.intelligencebank.com/webapp/1.0/resources"}}]},{"text":"?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"GET","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Parameters","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"p10:* {client api key}","type":"text"},{"type":"hardBreak"},{"text":"p20:* {user uuid}","type":"text"},{"type":"hardBreak"},{"text":"fileuuid: {file uuid}} ","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: version: {version number}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: preview=true - this will download a Preview image of the file with dimensions of up to 850 pixels width/height.","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: ext: {type of extension to download the file as}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: size: {percentage of original file (25, 50, 75, 100) }","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: cropwidth: {cropped output width}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: cropheight: {cropped output height}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: cropx: {x coordinate to start the crop}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: cropy: {y coordinate to start the crop}","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: compression: {compression quality (1-100) }","type":"text"},{"type":"hardBreak"},{"text":"OPTIONAL: compressiontype: {type of compression (see Note 5 below) }","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"?p10={apikey}&p20={useruuid}&fileuuid={resource uuid}&version={ version number }&ext={ file extension }&preview=true&size={ percentage of original file size }&cropwidth={ cropped output width }&cropheight={ cropped output height }&cropx={ x coordinate to start the crop }&cropy={ y coordinate to start the crop }&compression={ compression quality }&compressiontype={ type of compression }","type":"text"}]},{"type":"paragraph","content":[{"text":"Header:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"This needs to be set as a Cookie.","type":"text"}]},{"type":"paragraph","content":[{"text":"_aid: ","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Response","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"200 : OK","type":"text"},{"type":"hardBreak"},{"text":"401 : Access denied","type":"text"},{"type":"hardBreak"},{"text":"404 : File not found","type":"text"},{"type":"hardBreak"},{"text":"500 : Internal server error","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Actions","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"Process the streamed file","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to download the file with that fileuuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34&preview=true","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to download a preview of the file with that fileuuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34&size=25&ext=gif","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to download the file with that fileuuid at 25% of its original size, converted to a gif format","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34&compression=80&compressiontype=10","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to download the file with that fileuuid compressed at 80% using JPEG lossless compression","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34&cropwidth=200&cropheight=200&cropx=0&cropy=0 ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to download the file with that fileuuid cropped to 200x200px starting from the top left corner of the image","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34&cropwidth=200&cropheight=200&compression=50&compressiontype=10&fileinfo=true","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request the estimated file size of the file with that fileuuid if it was to be cropped to 200x200px, compressed at 50% using JPEG losslesscompression","type":"text"}]},{"type":"paragraph","content":[{"text":"Mandatory parameters:","type":"text","marks":[{"type":"strong"}]},{"text":" p10, p20, fileuuid","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Resources URL. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the version number is provided then that version's file will be downloaded. If the provided version number is not found then a 'not found' response will be provided","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If no version parameter is provided then the latest or current file version is downloaded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If no extension is provided, then the original will be returned.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"preview=true ","type":"text","marks":[{"type":"strong"}]},{"text":"parameter is set then the returned image will be a ","type":"text"},{"text":"png","type":"text","marks":[{"type":"strong"}]},{"text":" version of the original.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If cropping an image, the following 4 parameters must be specified: ","type":"text"},{"text":"cropwidth, cropheight, cropx ","type":"text","marks":[{"type":"em"}]},{"text":"and ","type":"text"},{"text":"cropy","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If size parameter is included in a URL which also contains cropping parameters, the cropping parameters (cropwidth, cropheight, cropx and cropy) need to be specified at the same percentage as the size parameters.","type":"text"},{"type":"hardBreak"},{"text":"e.g. The following two snippets would produce the same target part of the image just at different dimensions","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"-Without the size parameter: ","type":"text"},{"text":"&cropwidth=960&cropheight=600&cropx=800&cropy=500","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With the size parameter set to 50%: ","type":"text"},{"text":"&cropwidth=480&cropheight=300&cropx=400&cropy=250&size=50","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Types of compression:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1 = No compression","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2 = BZIP2 (Lossless Compression)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"8 = JPEG (Lossy Compression)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"10 = JPEG (Lossless Compression)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"11 = LZW (Lemple-Zif-Welch) (Lossless Compression)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"12 = Run-Length Encoding (Lossless Compression)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"13 = ZIP (Lossless Compression)","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the requested file. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete Resource Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&fileuuid={folder uuid}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to delete the file with that fileuuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Resources URL. The client MUST use DELETE when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the No Content Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create Resource","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user uuid}&folderuuid={folder uuid}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is a mulitpart/form-data. The client MUST use POST to send this payload to the Resources URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The name parameter in the header of the file component of the form MUST be called file1 i.e. name=file1.","type":"text"}]},{"type":"paragraph","content":[{"text":"The filename parameter in the header of the file component of the form MUST be the path to the file to be uploaded i.e. filename=","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported metadata fields are Title, Description, Tags (referred to as Keywords in the platform) and Global Filters. Other Custom Fields are NOT supported.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":" -------NEXT_PART_1431579477.49877\nContent-Disposition: form-data; name=\"options\"\n\n{\n \"folder\" : \"06da9efd9e96a973015a5571b65d4b6c\",\n \"filename\" : \"/opt/test.txt\",\n \"name\" : \"Test file\",\n \"description\" : \"this is a test file\"\n}\n-------NEXT_PART_1431579477.49877\nContent-Disposition: form-data; name=file1; filename=/opt/test.txt\nContent-Type: plain/text\n\none\ntwo\nthree\nfour\n\n-------NEXT_PART_1431579477.49877--","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"would request to upload the file called test.txt, save it within the folder with that uuid, give it the name \"Test file\" and a description of \"this is a test file\".","type":"text"}]},{"type":"paragraph","content":[{"text":"You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: multipart/form-data","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the No Content Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Update Resource","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two options for updating a resource. The first option is for updating the metadata of the resource only using standard POST url-form-encoded method. The second is for updating the resource file, and optionally the metadata too. The resource file can also be flagged that it should create a new version.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Option 1 - Update metadata only using url-encoded form","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The URL would contain the following parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}&fileuuid={resource uuid}","type":"text"}]},{"type":"paragraph","content":[{"text":"And the body of the request would contain the metadata to be updated. This will ","type":"text"},{"text":"overwrite the existing data so any existing tags or filters must also be sent back when updating this field","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"folder=685d6203ba83ae6969011ab785134c91&name=Archived%20Images&description=Old%20images&tags=California%2c%20trip%2c%20San%20Diego&filters={\"Country\":\"USA\"}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to update the name of the file with that uuid to the new value \"Archived Image\", set the description to \"Old image\" and set the keywords to \"California, trip, San Diego\", and add the filter Country with the value \"USA\"","type":"text"}]},{"type":"paragraph","content":[{"text":"the folder parameter with the uuid of the folder MUST be included","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported fields for metadata updates are Title, Description, Tags (referred to as Keywords in the platform) and Global Filters. Note: Tag and Filter values will ","type":"text"},{"text":"replace","type":"text","marks":[{"type":"strong"}]},{"text":" existing values. Other Custom Fields are NOT supported.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is simple key/value pairs. The client MUST use PUT to send this payload to the Resources URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You SHOULD use the following header","type":"text"}]},{"type":"paragraph","content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text"}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Resource Response: \"Resource updated successfully\". If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response","type":"text"}]},{"type":"paragraph","content":[{"text":"Option 2 - Update Resource File using multipart/form-data","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}&fileuuid={resource uuid}","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Example","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":" -------NEXT_PART_1431579477.49877\nContent-Disposition: form-data; name=\"options\"\n\n{\n \"folder\" : \"06da9efd9e96a973015a5571b65d4b6c\",\n \"filename\" : \"test2.txt\",\n \"name\" : \"Test 2 file\",\n \"description\" : \"this is the new version\",","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":" \"newVersion\" : true\n}\n-------NEXT_PART_1431579477.49877\nContent-Disposition: form-data; name=file1; filename=/opt/test.txt\nContent-Type: plain/text\n\none\ntwo\nthree\nfive\n\n-------NEXT_PART_1431579477.49877--","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"would request to upload the file called test2.txt, replace the existing file that is linked to that uuid, change the name to \"Test 2 file\" and the description to \"this is the new version\". It would also create a new version of teh resource. If a new version is not desired then set the \"newVersion\" parameter to false, or leave it out of the parameters.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also use this method to update the metadata only. In that case there would only be one part with no file part, and you would not set the filename parameter in the metadata. Note that the new version parameter only applies when there is a file being sent as part of the update. If there is no file then no new version will be created even if the \"newVersion\" parameter is present and set to true.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is a mulitpart/form-data. The client MUST use POST to send this payload to the Resources URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Resources URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/resources?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You MUST use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: multipart/form-data","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Resource Response: \"Resource updated successfully\". If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Thumbnail / Icon Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&type={ folder | people | file }&name={ folderuuid | fileuuid | useruuid | 'folder' | 'people }&ext={ file extension desired }","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvue&type=file&name=hg3v23ghj4hb34hhjhjg34&ext=PDF","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get the Thumbnail / Icon for the PDF version of the file with that fileuuid. If there was also. a DOCX version of the file then the 'ext' part of the request would change to DOCX","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Thumbnail / Icon URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Icon","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/icon?","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"Notes","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a name is provided but a custom icon cannot be found, and a client default Thumbnail / Icon cannot be found then the default icon for the type is returned.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the name and type and ext parameters are missing it will return the default resource Thumbnail / Icon","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a name is provided and the type is set to file and a valid ext is provided, then the ext Thumbnail / Icon is returned, otherwise the default resource icon is returned.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the requested file. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Download Presets Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request all the saved download presets.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Download Presets URL. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Download Presets URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/downloadpresets","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Download Preset Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Comments Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&fileuuid={ fileuuid }","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&fileuuid=hg3v23ghj4hb34hhjhjg34","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get any comments for the file with that fileuuid.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Comment URL. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Comments URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/comments","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Comment Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Comment","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}&fileuuid={ fileuuid }&version={version number}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&type=file&fileuuid=hg3v23ghj4hb34hhjhjg34comment=some%20text%20goes%20for%20a%20comment","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would create the comment and attach it to the file with that fileuuid. If there is a version number as part of the request then the comment will be attached to that version of the file, otherwise it will be attached to the latest version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is simple key/value pairs. The client MUST use POST to send this payload to the Comment URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Comments URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/comments","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Comment Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sync","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={user id}","type":"text"}]},{"type":"paragraph","content":[{"text":"POST data","type":"text"}]},{"type":"paragraph","content":[{"text":"apikey={apikey}&useruuid={user id}","type":"text"}]},{"type":"paragraph","content":[{"text":"&sync=[{\"folders\":[]},{\"files\":[{,,]}]","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":" apikey=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&useruuid=3nj34hvdsjds8dnfnfd87bhbvuef","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"&sync=[{\"folders\":[\"06da9efd9e96a973015a5571b65d4b6c\",\"334j3jkh3dsf76dsf7sdf7sdb6c\"]},{\"files\":[{\"fileuuid\":\"hg3v23ghj4hb34hhjhjg34dfsf\",\"updatedat\":\"2015-01-01 11:00:00\",\"annotation\":{\"annotation data\"}]}]","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would ask for the sync data for the two folders with uuids listed and for the file with that fileuuid, which has been updated with a new annotation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this payload is a key/value pair with the value of the sync key being a JSON format document. The client MUST use POST to send this payload to the Sync URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Sync URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/sync","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You SHOULD use the following header","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Content-Type: application/x-www-form-urlencoded ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Sync Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Search Request","type":"text"}]},{"type":"paragraph","content":[{"text":"?p10={apikey}&p20={useruuid}&searchterm={ word or words to search for }&folderuuid= {folder uuid to start search from }&fromdate={ date to search from in format YYYY-MM-DD}","type":"text"},{"text":"skip={starting position}&limit={number of resources to return}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The folderuuid and fromDate fields are optional.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&searchterm=supercalifraj","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get any documents that contain the term 'supercalifraj'","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&searchterm=super%20nova","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get any documents that contain the term 'super' or the term 'nova'","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&searchterm=*&fromDate=2017-01-01","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get all documents updated or created since Jan 1 2017","type":"text"}]},{"type":"paragraph","content":[{"text":"p10=adsferdftfgryfhgutjgiyhkgjhutyrgdnbvjhj&p20=3nj34hvdsjds8dnfnfd87bhbvuef&searchterm=*&fromDate=2017-01-01T10:20:09Z","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"would request to get all documents updated or created since Jan 1 2017, at 10:20:09 UTC","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"skip={starting position}&limit={number of resources to return}","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"If the limit parameter is included in the request then the number of resources returned will be the value of the limit parameter, starting from the first resource if there is no skip value present, or from the value of the skip parameter if it is present.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the skip parameter is included in the request and the limit parameter is not then the resources returned will be those starting from the skip value and ending at the last resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"The skip value is zero indexed based i.e. the first resource resides at skip=0. If the skip parameter is not included in the request then the starting point will be as if a skip value of 0 was included. If the skip value is larger than the number of resources in the folder, then no resource element will be returned.","type":"text"}]},{"type":"paragraph","content":[{"text":"The maximum number of results that can be returned at once is 100.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note this is a query string and not a payload. The client MUST append this string to the Search URL. The client MUST use GET when executing this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Search URL","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"https://XXXXX.intelligencebank.com/webapp/1.0","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://XXXXX.intelligencebank.com/webapp/1.0"}}]},{"text":"/search","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If folderuuid is not present in the URL then the search will start from the root folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Search requests responses cannot currently be paginated.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there is more than a single word in the searchterm then the term MUST be properly encoded with %20 or %2B for any spaces in the searchterm","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Upon successful completion of this operation, the server SHOULD return the Search Response. If the operation is not successful, the server MUST return the appropriate HTTP status code and the Error Response.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Responses","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is a list of the common responses from the server:","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Login Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following cookie","type":"text"}]},{"type":"paragraph","content":[{"text":"_aid: ","type":"text"}]},{"type":"paragraph","content":[{"text":"and the following body:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"{","type":"text"},{"type":"hardBreak"},{"text":" \"clientid\":,","type":"text"},{"type":"hardBreak"},{"text":" \"clientname\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"clientuuid\":\"clientuuid\",","type":"text"},{"type":"hardBreak"},{"text":" \"apikey\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"logintimeoutperiod\":,","type":"text"},{"type":"hardBreak"},{"text":" \"adminemail\":\"conatct email for site\",","type":"text"},{"type":"hardBreak"},{"text":" \"passwordexpiryperiod\":,","type":"text"},{"type":"hardBreak"},{"text":" \"userverificationperiod\":,","type":"text"},{"type":"hardBreak"},{"text":" \"offlineexpiryperiod\":,","type":"text"},{"type":"hardBreak"},{"text":" \"annotations\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"comments\":\"< 1 | null\",","type":"text"},{"type":"hardBreak"},{"text":" \"passwordexpired\":< 1 | null>,","type":"text"},{"type":"hardBreak"},{"text":" \"emailexpired\":< 1 | null>,","type":"text"},{"type":"hardBreak"},{"text":" \"versions\":\"< 1 | null>\",","type":"text"},{"type":"hardBreak"},{"text":" \"firstname\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"lastname\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"useruuid\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"thumbnail\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"foldericon\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"rowsOnPage\":\"\",","type":"text"},{"type":"hardBreak"},{"text":" \"defaultFolderSortOrder\":\"\"","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the POST /login operation is successful.","type":"text"}]},{"type":"paragraph","content":[{"text":"The _aid value returned in the cookie of the header is required in the header for all subsequent operations.","type":"text","marks":[{"type":"strong"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Folder Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"response\":\n {\n \"hasversions\":\"< 1 if versions is enabled | 0 >\",\n \"folder\":[\n {\n \"folderuuid\":\"\",\n \"name\":\"\",\n \"description\":\"\",\n \"createdtime\":\"\",\n \"comments\":\"\",\n \"perm\":\"\",\n \"resources\":\"\"\n },\n \"defaultorder\":\"\",\n \"sortorder\":\"\"\n },\n {\n ... another folder \n }\n ],\n \"resource\":[\n {\n \"resourceuuid\":\"\",\n \"resourcetype\":\"\",\n \"seen\":\"< 1 if user has opened this resource>\",\n \"title\":\"\",\n \"description\":\"\",\n \"sortorder\":\"\",\n \"updatedat\":\"\",\n \"processedat\":\"\",\n \"updatedby\":\"\",\n \"ownershiptype\":\"\",\n \"tags\":[],\n \"fileuuid\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\",\n \"origfilename\":\"\",\n \"resourcedate\":\"\",\n \"uploadedtime\":\"\",\n \"reviewdate\":\"\",\n \"printing\":\"< 1 if printing allowed>\",\n \"version\":\"\",\n \"annotations\":\"\",\n \"versions\":[\n {\n \"versionnumber\":\"\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"\",\n \"comment\":\"\",\n \"createdby\":\"\",\n \"ownershiptype\":\"\"\n }\n ]\n }\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the GET Root Folder Request, Folder Request, Create Folder, Update Folder operations are successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Resource Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"response\":\n {\n \"resource\":[\n {\n \"resourceuuid\":\"\",\n \"resourcetype\":\"\",\n \"seen\":\"< 1 if user has opened this resource>\",\n \"title\":\"\",\n \"description\":\"\",\n \"sortorder\":\"\",\n \"updatedat\":\"\",\n \"processedat\":\"\",\n \"updatedby\":\"\",\n \"ownershiptype\":\"\",\n \"tags\":[],\n \"fileuuid\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\",\n \"origfilename\":\"\",\n \"resourcedate\":\"\",\n \"uploadedtime\":\"\",\n \"reviewdate\":\"\",\n \"printing\":\"< 1 if printing allowed>\",\n \"version\":\"\",\n \"annotations\":\"\",\n \"versions\":[\n {\n \"versionnumber\":\"\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"\",\n \"comment\":\"\",\n \"createdby\":\"\",\n \"ownershiptype\":\"\"\n }\n ]\n }\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the Create Resource Request and Update Resource Request operations are successful.","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"estimatedFileSize\": \"\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the GET Resource Request with { fileinfo=true } has been successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Comment Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"response\":\n {\n \"comment\":{\n \"commentid\":\" \",\n \"comment\":\"\",\n \"createdat\":\"\",\n \"createdby\":\"\",\n \"updatedat\":\"\",\n \"updatedby\":\"\",\n \"version\":\"\",\n \"iconuuid\":\"\",\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the GET Comment Request operation is successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sync Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"folders\":\n {\n \"folder\":[\n {\n \"folderuuid\":\"\",\n \"hasversions\":\"< 1 if versions enabled, 0 if not >\",\n \"perm\":\"< permission level >\",\n \"resource\":[\n {\n \"resourceuuid\":\"\",\n \"resourcetype\":\"\",\n \"seen\":\"< 1 if previosly accessed, 0 if not >\",\n \"title\":\"\",\n \"description\":\"\",\n \"sortorder\":,\n \"processedat\":\"\",\n \"updatedat\":\"\",\n \"updatedby\":\"\",\n \"tags\":[],\n \"uploadedtime\":\"\",\n \"fileuuid\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\",\n \"origfilename\":\"\",\n \"annotations\":\"<1 if annotations enabled or 0>\",\n \"annotation\":[{},{ .. another annotation .. }],\n \"resourcedate\":\"2015-05-14 05:12:47\",\n \"printing\":\"<1 if printing allowed or 0>\",\n \"version\":\"\",\n \"tree\":[]\n \"versions\":[\n {\n \"versionnumber\":\"\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"UTC datetime file uploaded\",\n \"comment\":,\n \"createdby\":\"\"\n }] \n },{\n ..... next resource\n }\n ]\n },{\n ... next folder\n }\n ]\n },\n {\n \"files\": \n [\n file: {\n \"status\":\"\",\n \"resourceuuid\":\"\",\n \"resourcetype\":\"\",\n \"seen\":\"< 1 if previosly accessed, 0 if not >\",\n \"title\":\"\",\n \"description\":\"\",\n \"sortorder\":,\n \"processedat\":\"\",\n \"updatedat\":\"\",\n \"updatedby\":\"\",\n \"tags\":[],\n \"uploadedtime\":\"\",\n \"fileuuid\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\", \n \"origfilename\":\"\",\n \"annotations\":\"<1 if annotations enabled or 0>\",\n \"annotation\":[{},{ .. another annotation .. }],\n \"resourcedate\":\"\",\n \"resourcedate\":\"\",\n \"printing\":\"<1 if printing allowed or 0>\",\n \"version\":\"\",\n \"tree\":[]\n \"versions\":[\n {\n \"versionnumber\":\"\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"UTC datetime file uploaded\",\n \"comment\":,\n \"createdby\":\"\"\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\", \n }], \n }\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the Sync Payload operation is successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Search Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"numFound\":\"7\",\n \"doc\":[\n {\n \"uuid\":\"15e617346a2cc44edd72e59d86559b90\",\n \"title\":\"Version Test\",\n \"description\":\"\",\n \"id\":\"250597\",\n \"ext\":\"PDF\",\n \"data\":{\n \"location\":\"content\",\n \"snippet\":{\n \"ib_title\":\"Version Test\"\n }\n },\n \"file\": \n {\n \"resourceuuid\":\"\",\n \"resourcetype\":\"\",\n \"seen\":\"< 1 if previosly accessed, 0 if not >\",\n \"title\":\"\",\n \"description\":\"\",\n \"sortorder\":,\n \"processedat\":\"\",\n \"updatedat\":\"\",\n \"updatedby\":\"\",\n \"tags\":[],\n \"uploadedtime\":\"\",\n \"fileuuid\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"prevfiletype\":\"\",\n \"prevfilesize\":\"\", \n \"origfilename\":\"\",\n \"annotations\":\"<1 if annotations enabled or 0>\",\n \"annotation\":[{},{ .. another annotation .. }],\n \"resourcedate\":\"\",\n \"resourcedate\":\"\",\n \"printing\":\"<1 if printing allowed or 0>\",\n \"version\":\"\",\n \"tree\":[] \"versions\":[\n {\n \"versionnumber\":\"2\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"\",\n \"comment\":,\n \"createdby\":\"\" \"prevfiletype\":\"\",\n \"prevfilesize\":\"\", },{\n \"versionnumber\":\"1\",\n \"origfilename\":\"\",\n \"filetype\":\"\",\n \"filesize\":\"\",\n \"datecreated\":\"\",\n \"comment\":\"\",\n \"createdby\":\"\" \"prevfiletype\":\"\",\n \"prevfilesize\":\"\", }\n ]\n }}\n ]\n","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the Search Request operation is successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Download Presets Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with the following body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"presets\":[\n {\n \"uuid\":\"15e617346a2cc44edd72e59d86559b90\",\n \"name\":\"Preset Test\",\n \"fileType\":\"png\",\n \"compressionQuality\":\"60\",\n \"compressionType\":\"1\",\n \"fileSize\":\"custom\",\n \"customWidth\":200 \n \"customHeight\":200,\n \"cropWidth\":null,\n \"cropHeight\":null,\n \"id\":3322362,\n },\n {\n ... next download preset\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the Download Preset Request operation is successful.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"No Content Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code is returned with no body.","type":"text"}]},{"type":"paragraph","content":[{"text":"The server SHOULD return this response when the Delete Folder Request, Delete Resource Request, Rest Request and Comment Payload operations are successful","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Error Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP status code returned is in the 4xx or 5xx family and an appropriate error message is included in the body.","type":"text"}]}],"version":1}

Browser not supported