For the complete documentation index, see llms.txt. This page is also available as Markdown.

Documents

Resource managing the Documents in our DMS(Shelf)

Find an existing Resource by identifier

get
Path parameters
idinteger · int64Required

an identifier

Responses
200

successful operation

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
get/dms/resources/{id}

Update existing Resource

put
Path parameters
idinteger · int64Required

an identifier

Body
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
Responses
200

successful operation

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
put/dms/resources/{id}

get ONE existing share

get
Path parameters
idinteger · int64Required

an identifier

shareIdinteger · int64Required

an identifier

Responses
200

OK

application/json

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
get/dms/resources/{id}/shares/{shareId}
200

OK

Update existing Share

put
Path parameters
idinteger · int64Required

an identifier

shareIdinteger · int64Required
Body

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
Responses
200

successful operation

application/json

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
put/dms/resources/{id}/shares/{shareId}

delete an existing share

delete
Path parameters
idinteger · int64Required

an identifier

shareIdinteger · int64Required

an identifier

Responses
200

OK

application/json
contextstringOptional

message context

messageValuestringOptional

message

delete/dms/resources/{id}/shares/{shareId}
200

OK

upload/change a file transfer part

post
Path parameters
idinteger · int64Required

an identifier

tokenstringRequired

file-transfer token

partinteger · int64Required

unique part number

Responses
200

OK

application/json

Response wenn ein UploadPart angelegt wird

uploadUristringOptional

upload-url for the real (tm) upload

post/dms/resources/{id}/file-transfer/{token}/{part}
200

OK

upload/change a file transfer part

put
Path parameters
idinteger · int64Required

an identifier

tokenstringRequired

file-transfer token

partinteger · int64Required

unique part number

Body

Aktualisiert einen FilePart Upload

uploadEtagstringRequired

resulting ETag from UploadPart upload

Responses
200

OK

No content

put/dms/resources/{id}/file-transfer/{token}/{part}
200

OK

No content

put
Path parameters
idinteger · int64Required
Query parameters
newDeletionStatestring · enumRequiredPossible values:
Responses
200

OK

No content

put/dms/resources/{id}/deletion_state
200

OK

No content

Create new Resource

post
Body
Responses
200

successful operation

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
post/dms/resources

get all existing shares

get
Path parameters
idinteger · int64Required

an identifier

Responses
200

OK

application/json

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
get/dms/resources/{id}/shares
200

OK

Create new Share

post
Path parameters
idinteger · int64Required

an identifier

Body

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
Responses
200

successful operation

application/json

share informations

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicUrlPathstringRead-onlyOptional

der url-pfadanteil, der öffentlichen zugriff auf diese resource gibt

publicUrlCreatedAtstring · dateRead-onlyOptional

wann die öffentliche resource erstellt wurde

publicUrlDurationInMinutesinteger · int64Optional

wie viele Minuten bleibt dieser resource-pfad zugreifbar (null = unlimited)

availabilitystring · enumRequired

Bestimmt, wie oft eine öffentliche URL verfügbar ist

Possible values:
timesUsedinteger · int32Read-onlyOptional

Anzahl der Nutzungen

appIdstring · uuidOptional

App-ID

sharedByExternalRefstringOptional

Externer Verweis auf dieses Share

revisioninteger · int32Read-onlyOptional

Revision

eTagstringRead-onlyOptional

Hash der Revision

customanyOptional

Search-Dialog

publishStatestring · enumOptional

Veröffentlichungsstatus einer Dokument-Freigabe

Possible values:
etagstringOptional
post/dms/resources/{id}/shares

download the original or transformed document file

get
Path parameters
idinteger · int64Required

ID der DMS-Ressource

Query parameters
uiKeystringOptional

optional: Einschränkung auf eine bestimmte Transformation

dispositionstringOptional

optional: gewünschte Content-Disposition vom Request

Header parameters
If-None-MatchstringOptional
Responses
200

Response contains File

application/json
anyOptional
get/dms/resources/{id}/file

No content

upload/change the original document file

post
Path parameters
idinteger · int64Required

an identifier

Query parameters
sha256hashstringOptional
Body
filestring · binaryRequired
Responses
200

OK

application/json
contextstringOptional

message context

messageValuestringOptional

message

post/dms/resources/{id}/file
200

OK

start a file transfer (chunked and multiparted)

post
Path parameters
idinteger · int64Required

an identifier

Body
fileNamestringRequired

filename (komplett) der zieldatei

Responses
200

OK

application/json
tokenstringOptional

token für den transfer file

post/dms/resources/{id}/file-transfer
200

OK

terminate/delete a file transfer

post
Path parameters
idinteger · int64Required

an identifier

tokenstringRequired

file-transfer token

Responses
200

OK

application/json
anyOptional
post/dms/resources/{id}/file-transfer/{token}/terminate
200

OK

No content

finish a file transfer

post
Path parameters
idinteger · int64Required

an identifier

tokenstringRequired

file-transfer token

Body
partCountinteger · int64Required

anzahl der Teile, die hochgeladen wurden

sha256CheckstringOptional

sha256 checksumme des komplette files (optional)

Responses
200

OK

application/json
anyOptional
post/dms/resources/{id}/file-transfer/{token}/finish
200

OK

No content

post
Path parameters
dmsKeystringRequired
Body
purposestringOptional
uiSortinteger · int32Optional
Responses
200

OK

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
post/dms/resources/dms-key/{dmsKey}
200

OK

Download File using a UUID

get
Path parameters
uuidstring · uuidRequired

UUID der DMS-Ressource

Query parameters
dispositionstringOptional

optional: gewünschte Content-Disposition vom Request

Header parameters
If-None-MatchstringOptional
Responses
200

Response contains File

application/json
anyOptional
get/dms/resources/{uuid}/fileUUID

No content

get metadata of all files for a document in revision order

get
Path parameters
idinteger · int64Required

an identifier

Responses
200

OK

application/json

file data

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

publicFileExtensionstringRead-onlyOptional

file-extension of this entry

publicFileNamestringRead-onlyOptional

file-name (without extension) of this entry

storageHandlestringRead-onlyOptional

current reference of this file in our storage

contentTypestringRead-onlyOptional

detected content type

fileSizeinteger · int64Read-onlyOptional

fileSize

revisionNumberinteger · int32Read-onlyOptional

revision number of this file

get/dms/resources/{id}/revisions
200

OK

get the protocol of all changes on the document in chronological order

get
Path parameters
idinteger · int64Required

an identifier

Responses
200

OK

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

documentRefinteger · int64Optional

Verweis auf das zugehörige Shelf-Document

messagestringOptional

Mitteilung des Protokolls

protocolTypestring · enumOptional

Art des Protokolleintrags

Possible values:
timestampstring · date-timeOptional

Zeitpunkt, an dem der Eintrag erstellt wurde

userNamestringOptional

Nutzer, der den Eintrag ausgelöst hat

get/dms/resources/{id}/protocol
200

OK

download the original or transformed document file by alias

get
Path parameters
aliasstringRequired

Alias der DMS-Ressource

Query parameters
dispositionstringOptional

optional: gewünschte Content-Disposition vom Request

Header parameters
If-None-MatchstringOptional
Responses
200

Response contains File

application/json
anyOptional
get/dms/resources/{alias}/alias

No content

get ShelfFile by ShelfFile-ID

get
Path parameters
shelfIdinteger · int64Required
Query parameters
dispositionstringOptional
Header parameters
If-None-MatchstringOptional
Responses
200

Response contains File

application/json
anyOptional
get/dms/resources/file/{shelfId}/file

No content

get Subfiles from ShelfFile by ShelfFileId

get
Path parameters
shelfFileIdinteger · int64Required
Responses
200

OK

application/json

subFiles for this file

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

namestringOptional

fileName

parentPathstringOptional

Parent-Path

fullPathstringOptional

Full-Path

modifiedAtstring · date-timeOptional

file last modified

contentTypestringOptional

Inhaltstyp

get/dms/resources/file/{shelfFileId}/entries
200

OK

get SubFile as Source from ShelfFIle

get
Path parameters
shelfFileIdinteger · int64Required

ID der shelfFile

subFileIdinteger · int64Required

ID der subFile

Query parameters
dispositionstringOptional

optional: gewünschte Content-Disposition vom Request

Header parameters
If-None-MatchstringOptional
Responses
200

Response contains File

application/json
anyOptional
get/dms/resources/file/{shelfFileId}/entries/{subFileId}/file

No content

get shelf documents by reference type and id

get
Query parameters
refTypestringRequired
refIdinteger · int64Required
Responses
200

OK

application/json
versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

descriptionstringOptional

description of this document

entryDatestring · dateRequired

Date of this Entry/Document

plannedRemovalDatestring · dateRead-onlyOptional

Automatische Löschung ab

customanyOptional

Search-Dialog

notestringOptional

Notiz

externalIdstring · uuidRead-onlyOptional

Externe Id

aliasstringOptional

Alias

statestring · enumRead-onlyOptional

Status eines Dokuments

Possible values:
deletionStatestring · enumRead-onlyOptional

Löschungsstatus

Default: NOT_YETPossible values:
get/dms/resources/byRef
200

OK

Last updated

Was this helpful?