create document forurl
/members/{member}/groups/{group}/documents/forurl [POST]
| API Support | Available since | Last updated | Output |
|---|---|---|---|
| 4.0012 | 6.0000 | xml, json |
Description
Create a new PSML document.
There are various ways of specifying the target destination:
- If the document configuration for the type specified has
<folder>or<filename>defined, then these are used to compute the document path. - Otherwise, the URI on the request or the following parameters are used:
url,parenturl,name.
Parameters
| Name | Description | Required | Type | Default value |
|---|---|---|---|---|
| name | Name of file to create – without extension (required if request has no url and filename not specified in document configuration) | maybe | string | |
| parenturl | URL of parent URI (required if request has no url and folder not specified in document configuration) | maybe | url | |
| url | URL of target URI (required if request has no parenturl and folder/filename not specified in document configuration) | maybe | url | |
| description | Description of new document | no | string | |
| docid | Document ID | no | string | |
| labels | Comma-separated list of document label values | no | string | |
| notification-content | Content of notification | no | string | |
| notification-groups | Comma-separated list of group names to notify (optional, default to current group name) | no | string | |
| notification-labels | Comma-separated list of label values for the note (if exists creates a note) | no | string | |
| notification-subject | Subject of notification (default to document title or Document Created) | no | string | |
| notify | Notification behavior | no | notification | silent |
| notify-async | Whether emails are sent asynchronously (for slow email servers) | no | boolean | false |
| template.* | template.[name] used as a param by the template to create the content | no | defined in template | |
| title | Display title of new document | no | string | |
| type | Type of new document (optional) | no | string | default |
Permission
This service requires contributor or higher.
Response
The XML output follows this format:
<document-creation renamed="true"
original-name="New_document.psml">
<uri id="1234"
scheme="https"
host="localhost"
port="443"
path="/ps/jb/group1/documents/new_document.psml"
decodedpath="/ps/jb/group1/documents/new_document.psml"
external="false"
mediatype="application/vnd.pageseeder.psml+xml"
created="2013-12-19T15:14:54+11:00">
<displaytitle>New document</displaytitle>
</uri>
</document-creation>
The <uri> element is the URI that was create by this service.
Error Handling
| Code | Cause / Description |
|---|---|
| 0x0000 | The name is required |
| 0x120A | Invalid Document ID |
| 0x1201 | Illegal character in filename |
| 0x1209 | Existing Document ID |
| 0x1211 | Existing URI |
| 0x1216 | Invalid destination |
| 0x1217 | Two contradictory parameters have been specified (url and name or url and parenturl or url and parentfolder or parenturl and parentfolder) |
| 0x201B | Unable to create XRefs |
| 0x0204 | The Member was not found |
| 0x1222 | Invalid Publication ID |
| 0x1223 | Invalid Publication Type |
| 0x1231 | Publication ID is already being used |
| 0x6202 | Invalid PSML document configuration |