2. DMS Endpoints
Schema
The following graphic shows all REST endpoints that are available in the DMS Service API. Endpoints which have in its path a /native are not part of the Core-API.
Endpoint overview
HTTP Method | Endpoint | Description | Core | As of | Until |
|---|---|---|---|---|---|
POST / POST | Imports DMS objects. One endpoint is Multipart and the other application/json. | yes | 3.0.0 |
| |
DELETE | Deletes a DMS object identified by objectId. | yes | 3.0.0 |
| |
GET | Retrieves the metadata of a DMS object identified by objectId. | yes | 3.0.0 |
| |
PATCH | Updates all metadata, location and/or object type of a DMS object identified by objectId. | yes | 3.0.0 |
| |
POST | Updates all metadata, content, location and/or object type of a DMS object identified by objectId. | yes | 3.0.0 |
| |
GET | Gets the content metadata of a DMS objects identified by objectId. | yes | 3.0.0 |
| |
GET | Gets the pdf rendition of the contents of a DMS objects identified by objectId. | yes | 5.0.0 |
| |
GET | /api/dms/objects/{objectId}/contents/renditions/pdf/native/annotated | Gets the pdf of the contents with annotations of a DMS object identified by objectId. | no | 6.5.0 |
|
GET | Gets the ocr rendition of the contents of a DMS objects identified by objectId. | yes | 5.0.0 |
| |
GET | /api/dms/objects/{objectId}/contents/renditions/thumbnail/{index} | Gets the thumbnail of the first page of the contents of a DMS objects identified by objectId. | yes | 5.0.0 |
|
GET | Gets the content related to a DMS object identified by objectId. | yes | 3.0.0 |
| |
POST | Updates the content file of a DMS object identified by objectId. | yes | 3.0.0 |
| |
DELETE | Delete the content file of a DMS object identified by objectId. | yes | 5.5.0 |
| |
GET | Retrieves the content element with the given index from the DMS object. | no | 3.0.0 |
| |
POST | Replaces the content element with the given index in the DMS object. | no | 3.0.0 |
| |
PUT | Inserts a content element before the given index in the DMS object. | no | 3.0.0 |
| |
DELETE | Deletes the content element with the given index in the DMS object. | no | 3.0.0 |
| |
GET | Retrieves all content elements of the DMS object in a ZIP archive. | no | 3.0.0 |
| |
PATCH | Locks (checkout) a document and locks it for content editing. | no | 3.3.0 |
| |
PATCH | Unlocks (undo checkout) a document and therefore the lock for editing the content. | no | 3.3.0 |
| |
GET | Retrieves all annotations which are placed on the content of a DMS object. | no | 6.5.0 |
| |
POST | Insert or Update annotations on the content of a DMS object. | no | 6.5.0 |
| |
DELETE | /api/dms/objects/{objectId}/contents/native/annotations/{annotationId} | Delete annotation on the content of a DMS object. | no | 6.5.0 |
|
GET | Retrieves the history entries of a DMS object identified by | yes | 3.0.2 |
| |
POST | Inserts a custom history entry with the code 470 or 471. | no | 3.3.0 |
| |
GET | Retrieves the system metadata of all versions of a DMS object. | yes | 6.1.0 |
| |
GET | Retrieves the field metadata of a specific version of a DMS object. | yes | 6.1.0 |
| |
DELETE | Deletes a content change version of a DMS object. | yes | 6.2.0 |
| |
GET | /api/dms/objects/{objectId}/versions/{versionNumber}/contents/file | Retrieves the content of a content change version of a DMS object. | yes | 6.2.0 |
|
POST | /api/dms/objects/{objectId}/versions/{versionNumber}/actions/restore | Restores a version of a DMS object. | yes | 6.2.0 |
|
DELETE | Deletes an object from the recycle bin. | yes | 5.3.0 |
| |
POST | Restores an object from the recycle bin. | yes | 5.3.0 |
| |
|
|
|
|
|
|
GET | Returns a name for the DMS object based on a hit list configuration. | no | 5.4.0 |
| |
GET | Returns all locations in which the DMS object is present. | no | 4.0.1 |
| |
GET | Returns all variants for the DMS object identified by | no | 3.1.0 |
| |
POST | Creates a new variant for the DMS object identified by | no | 3.1.0 |
| |
GET | Returns the active variant for the DMS object identified by | no | 6.8.0 |
| |
PUT | Activates the variant for the DMS object identified by | no | 3.1.0 |
| |
GET | Returns all links of the object to other DMS objects. | no | 6.4.0 |
| |
POST | Insert or Update links to other DMS objects. | no | 6.4.0 |
| |
DELETE | Delete a link to a DMS object. | no | 6.4.0 |
| |
GET | Returns all notes for a specific object. | no | 6.4.0 |
| |
POST | Insert or Update notes. | no | 6.4.0 |
| |
DELETE | Delete a note. | no | 6.4.0 |
| |
GET | Returns a byte sequence of the osfile. | no | 6.5.0 |
| |
|
|
|
|
|
|
POST | Queries for DMS objects. | yes | 3.0.0 |
| |
POST | Queries for DMS objects with query syntax of enaio® appconnector. | no | 3.0.0 | < 6.0.0 | |
|
|
|
|
|
|
POST | Add DMS objects to the favourites portfolio |