Web service API

How to use PageSeeder's Web service API


/members/{member}/groups/{group}/externaluris/{uri} [PATCH]



Edit an existing 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 the URL of an external URI is modified, the ancestor folder URIs 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 modify these URIs with folder=false, the original URI will be INACCESSIBLE in hierarchical browsing.


NameDescriptionRequiredTypeDefault value
descendant-groupsComma-separated list of group names or IDs to add the descendant URIs to.nostring
descriptionThe new description.nostring
folderIf this URI is a folder (use with caution – SEE NOTE ABOVE)[true|false|inherit].nostring
groupsComma-separated list of group names or IDs to add the URI to.nostring
labelsComma-separated list of the new label values.nostring
mediatypeThe new mediatype (URI owner only).nostring
notifyIf the change should notify the group [normal|announce|silent].nostringsilent
notify-asyncWhether emails should be sent asynchronously (for slow email servers).nobooleanfalse
sizeThe new size in bytes (URI owner only).nolong
titleThe new title.nostring
urlThe new URL.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