Web service API

How to use PageSeeder's Web service API

create externaluri

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



Create an external URI.

Some parameters can only be used if the group on the request is the URI owner (i.e. the group has a groupfolder which covers the url specified or editurls is true in the advanced group configuration).

The parameter folder=inherit means it uses the value set by the URI owner. If no value has been set by the URI owner, folder will default to false.


When an external URI is created, the ancestor folder URIs for that URI will be created automatically (this is to allow hierarchical browsing) e.g. for URL http://example.com/acme/test/my.html the following folder external URIs will be created:

  • http://example.com/acme/test
  • http://example.com/acme

So they don't appear in search results or flat browsing, these folders are set as archived. If this service is later used to create these URIs, they will be unarchived but the folder parameter will be ignored because folder=false would interfere with hierarchical browsing.


NameDescriptionRequiredTypeDefault value
urlThe URL.yesurl
descriptionThe description.nostring
folderIf this URI is a folder (ignored if URI already exists – SEE NOTE ABOVE[true|false|inherit].nostringinherit
labelsA comma-separated list of label values.nostring
mediatypeThe mediatype (URI owner only).nostring
notifyIf the creation should notify the group [normal|announce|silent].nostringsilent
notify-asyncWhether emails should be sent asynchronously (for slow email servers).nobooleanfalse
sizeThe size in bytes (URI owner only).nolong
titleThe title.nostring


Permissions requirements to be updated.


The output has the following format:

    <uri id="[id]"
         path="[path]" ...>

Error Handling

No specific errors expected for this service.

Created on , last edited on