Skip to main content

DocumentConfigDto

The document itself as the editors address it: what to fetch, under which revision key, and what this caller may do with it.

NameTypeDescriptionNotes
fileTypeStringThe format the editors treat the content as, without the leading dot. For a file that had to be converted this is the format it was converted to, not the one it is stored under.[optional] [example: docx] [nullable]
infoInfoConfigDtoThe facts the editor information panel shows about the document.[optional]
isLinkedForMeBooleanWhether the caller opened the original document rather than a link pointing at it, which matters only for formats whose editing is restricted through links.[optional] [example: false]
keyStringIdentifies the exact revision to the editors: everyone who receives the same key joins the same co-editing session, and the key changes as soon as the document is saved.[optional] [example: 1_512_3] [nullable]
permissionsPermissionsConfigDtoWhat this caller may do inside the editor - edit, comment, review, fill, download, print, copy and chat.[optional]
sharedLinkParamStringThe name of the query parameter that carries the external share key. It is set only when the document was opened through an external link.[optional] [example: share] [nullable]
sharedLinkKeyStringThe external share key this opening runs under, empty when the caller opened the document as a portal member. The editors pass it back on every request they make for the document.[optional] [example: HkQd9nT2] [nullable]
referenceDataFileReferenceDataDtoHow another spreadsheet names this document in a formula. Pass it to POST api/2.0/files/file/referencedata to resolve such a reference.[optional]
titleStringThe name the editors display. When a past version was opened, the moment that version was created is appended to it in brackets.[optional] [example: Budget 2026.xlsx] [nullable]
urlURI (uri)Where the editors fetch the content. It is addressed to the host the document service can reach, which is not necessarily the address a browser should follow.[optional] [example: https://portal.example.com/filehandler.ashx?action=download&fileid=512] [nullable]
isFormBooleanWhether the document is a fillable PDF form. A PDF that the portal has never classified is inspected while the configuration is built, so the answer is trustworthy even for a freshly uploaded file.[optional] [example: false]
optionsDocumentOptionsDtoExtra instructions for the editors, currently the watermark to draw over the document. It is empty when the room sets no watermark.[optional]