Creating Folders - ACS - Reference Guides

ACS Integration Guide

Product
ACS
Platform
7.9
Category
Reference Guides
Language
English
Target Audience
public

To add a folder into a book or folder, a CKS user must use the POST method on the folder list resource relative to this book or this folder.

WADL file

Resource

Method

folder.wadl

/cks/instance/<service_id>-${Service_Status}/book/
{book_id}/
folder

POST

The following example shows how to create a folder for the user Albert Einstein in the book /cks/instance/<service_id>-${Service_Status}/book/13/. The id of this new folder is 39 and its reference is /cks/instance/<service_id>-${Service_Status}/book/13/folder/39.

The request line is:

POST /cks/instance/<service_id>-${Service_Status}/book/13/folder?afs:login=login://aeinsten:albert@CKS/<service_id>-${Service_Status}

The request body is:

<result xsi:type="cks.ws.folder" xmlns="antidot:cks:input"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<description>This is folder in book 13</description>
<name>Folder of Albert</name>
</result>

The reply data is:

<value xsi:type="ws.response" xmlns="antidot:cks:output"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<query xsi:type="ws.response.query">
<result xsi:type="cks.ws.folder"
reference="/cks/instance/<service_id>-${Service_Status}/book/13/folder/39">
<id>39</id>
<description>This is folder in book 13</description>
<name>Folder of Albert</name>
</result>
</value>