Web service API

How to use PageSeeder's Web service API

groupfolders

/members/{member}/groups/{group}/groupfolders [POST]

com.pageseeder.groupfolder.CreateGroupFolder

Description

Warning!

This class is not part of the public API, and may be subject to change!

Create a new group folder with the path provided.

If groups or editgroups are specified this service will return HTTP 202 and start an Asynchronous process to share all document edits and xrefs.

Note

The path parameter can end with the suffix "/*" but if it does not then the suffix will be added.

Parameters

Name Description Required Type Default value
editgroups the groups the folder will be shared to and editable - comma-separated list of names (one of public, groups, editgroups required) conditional strings
groups the groups the folder will be shared to - comma-separated list of names (one of public, groups, editgroups required) conditional strings
path the full path of the group folder beginning with / (/* suffix will be added automatically) yes path
public whether URIs should be accessible to public (one of public, groups, editgroups required) conditional boolean

Permission

Only Administrator s can invoke this generator.

Response

If successful, the created group folder is returned as a  <groupfolder> element wrapped in a <groupfolder-creation> element.

 <groupfolder-creation>
   <groupfolder id="[groupuri id]"
   scheme="[scheme]"
     host="[host]"
     port="[port]"
     path="[path]"
     external="[true|false]"
     public="[true|false]"
     sharing="[private|shared]">
      <sharing status="[private|shared]" [hidden="2"] [public="true"]>
       <share editable="true" shareedits="true" sharexrefs="true" addcomments="true" owner="true">
         <group name="my-group1".../>
       </share>
       <share editable="true" shareedits="false" sharexrefs="true" addcomments="false">
         <group name="my-group2" .../>
       </share>
       <share editable="false" shareedits="true" sharexrefs="false" addcomments="true">
         <group name="my-group3" .../>
       </share>
      </sharing>
   </groupfolder>
   [<thread> ... </thread>]
 </groupfolder-creation>

Error Handling

0x1403 If the group folder URL already exists in group
0x140A A public or group parameter is required
0x140B Invalid path
0x140C Group folder path not in group
0x140D Invalid group
0x1410 The groups parameter can not contain the owner group
0x1411 A group can not be in both the groups and editgroups parameters
0x6401 There is no default group folder for the group

Created on , last edited on