Web service API

How to use PageSeeder's Web service API

create uri version

/members/{member}/groups/{group}/uris/{uri}/versions [POST]



Create a new version

Adds a version to a uri or if the uri is a folder the uris under it.

If the URI is a folder this service will start an Asynchronous process.


NameDescriptionRequiredTypeDefault value
nameThe version number or nameyesstring
descriptionThe version contentnostring
labelsGeneral labels for comment (e.g. Important, Typo)nostring
notifySend notification flag, e.g. 'silent', 'normal', 'announce'noenumsilent

Notify parameter

This parameter must be one of:

  • normal  notify based on each member's notification settings;
  • announce  will ignore members' individual notifications settings;
  • silent  no notification



Undocumented permissions requirements.


If {uri} is valid, the output has the following format:

 <version-creation [warning="[warning]"]
   <version id="[id]"
            name="[version name]"
     <author id="12" ... >
       <fullname>John Jones</fullname>
     <description>[content of version]</description>

If {uri} is invalid, the return is:

   <thread ...>...</thread>

Error Handling

CodeCause / Description
0x0201The name  is required.
0x0202The group was not found, when group is invalid.
0x0204The member was not found, when (member and url is invalid).
0x0206The group was not found, when (member and group is invalid).
0x020EThe group was not found, when (member, group and uri is invalid).

Created on , last edited on