Loading
API docs by Redocly

DFS DMS API (latest)

Download OpenAPI specification:

Document

The Document API

Delete a document

Deletes a document specified by Id. Only a person with "WRITE" access can successfully call this endpoint.

Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a document by Document Id

Retrieves a document by Document Id. Only a person with "READ" access can successfully call this endpoint.

Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "filename": "string",
  • "digitalSignature": "string",
  • "createDate": "2019-08-24T14:15:22Z",
  • "contractId": "dbf32426-cf38-4818-9c6e-3230d889fa51",
  • "customAttributes": "string",
  • "externalId": "string",
  • "dmsDocumentMetadataId": 0,
  • "validTill": "2019-08-24T14:15:22Z",
  • "isActive": true,
  • "extension": "string",
  • "mimeType": "string",
  • "languageTwoLetterIsoCode": "string",
  • "lastUpdatedDate": "2019-08-24T14:15:22Z",
  • "documentMetadata": {
    },
  • "file": "string"
}

Upload a new version of a document or update document registration

Uploads a new version of an existing document or updates document registration. Note the following:

  • The caller will need to have "WRITE" access to the metadata or to the replaced document.
  • When uploading a document, do not supply fileType. Upload of documents bigger than 150MB might fail due to technical limitations.
  • When updating a registered proxied document, do not supply file.
  • When updating a registered reference document, do not supply fileType, filename or file.

    Possible ApiError.SubCode values:

    FileNotInWhitelist: The format of the provided file is not in the whitelist defined in DMS settings.
Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
filename
string or null
customAttributes
string or null
externalId
string or null

Set a unique external-id for the document. A document may later be fetched by the external-id alone.

validTill
string or null <date-time>

Set validity of the document. This field is informational only and does not effect the active state of the document.

file
string or null <byte>

If uploading a file, set the uploaded file in base64 format.

fileType
string or null

Responses

Request samples

Content type
{
  • "filename": "string",
  • "customAttributes": "string",
  • "externalId": "string",
  • "validTill": "2019-08-24T14:15:22Z",
  • "file": "string",
  • "fileType": "string"
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a document by External Id

Retrieves a document by External Id. Only a person with "READ" access can successfully call this endpoint.

Authorizations:
Bearer
path Parameters
externalId
required
string
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "filename": "string",
  • "digitalSignature": "string",
  • "createDate": "2019-08-24T14:15:22Z",
  • "contractId": "dbf32426-cf38-4818-9c6e-3230d889fa51",
  • "customAttributes": "string",
  • "externalId": "string",
  • "dmsDocumentMetadataId": 0,
  • "validTill": "2019-08-24T14:15:22Z",
  • "isActive": true,
  • "extension": "string",
  • "mimeType": "string",
  • "languageTwoLetterIsoCode": "string",
  • "lastUpdatedDate": "2019-08-24T14:15:22Z",
  • "documentMetadata": {
    },
  • "file": "string"
}

Upload a new version of a document

Uploads a new version of an existing document to DMS as a stream. The values need to be passed as multipart/form-data and the actual document needs to be passed as the last parameter and as a stream. Note the following:

  • DMS storage type should be Azure Blob for streaming functionality to work.
  • The caller will need to have "WRITE" access to the metadata or to the replaced document.
Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema: multipart/form-data
filename
required
string <string>

The name of the document in the storage.

externalId
string <string>

The external ID of the document. Must be unique if passed.

customAttributes
string <string>

Custom attributes of the document

validTill
string <date-time>

The validity date of the document. This field does not effect the active state of the document.

file
required
string <binary>

The document stream to upload.

Responses

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Update document metadata

Updates document metadata of an existing document. The caller will need to have “WRITE” access to both the old and the new metadata, or to the document itself. If both metadata-id and metadata-reference-id are supplied, metadata-id takes precedence.

Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
documentMetadataId
integer or null <int32>
documentMetadataReferenceId
string or null

Responses

Request samples

Content type
{
  • "documentMetadataId": 0,
  • "documentMetadataReferenceId": "string"
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Upload or register a document

Uploads or registers a document to DMS. Note the following:

  • The caller will need to have "WRITE" access to the metadata. If the access is given through owner-specific access policy, the caller needs to have the right relation with at least one of the specified owners.
  • A new document cannot be assigned to an inactive metadata.
  • When uploading a document, do not supply fileType, proxyParticipantUid or referenceDocumentId. Upload of documents bigger than 150MB might fail due to technical limitations.
  • When registering a proxied document, supply proxyParticipantUid, fileType and externalId. Do not supply file.
  • When registering a reference document, supply referenceDocumentId. Do not supply proxyParticipantUid, fileType, languageTwoLetterIsoCode, filename or file. The referenced document must be under a public metadata (which all members and/or contacts have READ access to). The referencing document must be under a metadata which does not expand the access to the referenced document. The referenced document may not be proxied.

    Possible ApiError.SubCode values:

    FileNotInWhitelist: The format of the provided file is not in the whitelist defined in DMS settings.
Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The document to save

filename
string or null
contractId
string or null <uuid>

Set link to an entity in DFS (portfolio, instrument, credit request) to later be found through search.

ownerIds
Array of integers or null <int32> [ items <int32 > ]

Set owners of a document. A client-type document must have at least one contact as owner. General-type documents should not have contacts as owners.

customAttributes
string or null
externalId
string or null

Set a unique external-id for the document. A document may later be fetched by the external-id alone.

validTill
string or null <date-time>

Set validity of the document. This field is informational only and does not effect the active state of the document.

dmsDocumentMetadataId
integer <int32>

Set under which metadata will the document be using metadata id. If both metadata id and metadata reference id are supplied, this field takes precedence.

metadataReferenceId
string or null

Set under which metadata will the document be using metadata reference id.

languageTwoLetterIsoCode
string or null
file
string or null <byte>

If uploading a file, set the uploaded file in base64 format.

proxyParticipantUid
string or null <uuid>

If registering a proxied document, set the proxy-participant-uid.

fileType
string or null
referenceDocumentId
integer or null <int32>

If registering a referenced document, set the reference-document-id.

Responses

Request samples

Content type
{
  • "filename": "string",
  • "contractId": "dbf32426-cf38-4818-9c6e-3230d889fa51",
  • "ownerIds": [
    ],
  • "customAttributes": "string",
  • "externalId": "string",
  • "validTill": "2019-08-24T14:15:22Z",
  • "dmsDocumentMetadataId": 0,
  • "metadataReferenceId": "string",
  • "languageTwoLetterIsoCode": "string",
  • "file": "string",
  • "proxyParticipantUid": "7fec805a-0620-484b-855b-42da4bcb4859",
  • "fileType": "string",
  • "referenceDocumentId": 0
}

Response samples

Content type
application/json
0
0

Upload a document

Uploads a document to DMS as a stream. The values need to be passed as multipart/form-data and the actual document needs to be passed as the last parameter and as a stream. Note the following:

  • DMS storage type should be Azure Blob for streaming functionality to work.
  • The caller will need to have "WRITE" access to the metadata. If the access is given through owner-specific access policy, the uploader needs to have the right relation with at least one of the specified owners.
  • A new document cannot be assigned to an inactive metadata.
Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema: multipart/form-data
filename
required
string <string>

The name of the document in the storage.

contractId
string <uuid>

Links the document to a contract in DFS.

externalId
string <string>

The external ID of the document. Must be unique if passed.

ownerIds
Array of integers <int32> [ items <int32 > ]

The persons owning the document.

customAttributes
string <string>

Custom attributes of the document

validTill
string <date-time>

The validity date of the document. This field does not effect the active state of the document.

dmsDocumentMetadataId
integer <int32>
Default: 0

The metadata ID of the document. If both dmsDocumentMetadataId and metadataReferenceId are supplied, this field takes precedence.

metadataReferenceId
string <string>

The metadata reference ID of the document. If both dmsDocumentMetadataId and metadataReferenceId are supplied, the field dmsDocumentMetadataId takes precedence.

languageTwoLetterIsoCode
string <string>

Set a specific language for the document.

file
required
string <binary>

The document stream to upload.

Responses

Response samples

Content type
application/json
0
0

Generate a digital signature

Generates a digital signature.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
content
string or null <byte>

Responses

Request samples

Content type
{
  • "content": "string"
}

Response samples

Content type
application/json
{
  • "digSig": "string"
}

Search documents by given criteria

Search documents by given criteria. The caller cannot retrieve documents for which they does not have “READ” access to. Note that specifying specific persons in personAssignment parameter is required when retrieving documents through Hierarchy access policy level or when applications retrieve documents when data segregation is enabled.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
page
integer <int32>
pageSize
integer <int32>
sortOrder
string (SortOrder)
Enum: "Ascending" "Descending"
sortBy
string or null

sort by one of the following fields: id (default), filename, createdate, DocumentCategoryId, DocumentMetadataId, mimeType, ValidTill

documentTypeId
integer or null <int32>

filter by document type

documentMetadataIds
Array of integers or null <int32> [ items <int32 > ]

filter by document metadata

documentCategoryIds
Array of integers or null <int32> [ items <int32 > ]

filter by document category

createDateFrom
string or null <date-time>

filter by CreateDateFrom

createDateTo
string or null <date-time>

filter by CreateDateTo

contractId
string or null <uuid>

filter by entities linked to documents.

isActive
boolean or null

filter by status of the document

filename
string or null

filter by file name

languageTwoLetterIsoCode
string or null

filter by language

object (PersonAssignment)

filter by specific people with assignment to the document, either as owners or as people with direct document access. If no persons are specified, hierarchy access to documents will not be checked

Responses

Request samples

Content type
{
  • "page": 0,
  • "pageSize": 0,
  • "sortOrder": "Ascending",
  • "sortBy": "string",
  • "documentTypeId": 0,
  • "documentMetadataIds": [
    ],
  • "documentCategoryIds": [
    ],
  • "createDateFrom": "2019-08-24T14:15:22Z",
  • "createDateTo": "2019-08-24T14:15:22Z",
  • "contractId": "dbf32426-cf38-4818-9c6e-3230d889fa51",
  • "isActive": true,
  • "filename": "string",
  • "languageTwoLetterIsoCode": "string",
  • "personAssignment": {
    }
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "page": 0,
  • "pageSize": 0,
  • "pageCount": 0,
  • "totalCount": 0
}

DocumentAccess

The Document Access API

Retrieve a list of access policies

Retrieves a list of access policies supported by DMS.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve a list of access policy levels

Retrieves a list of access policy levels supported by DMS.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve person-specific access to the specified document

Retrieves a list of persons and their assigned access policy for a specified document. Only a member with “MANAGE” access can successfully call this endpoint.

Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>

The Document ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assign person-specific access to a specific document

Assign access policies of specific persons to the specified document. Only a member with “MANAGE” access can successfully call this endpoint. A successful call will override existing person-specific access policies assigned to this document.

Authorizations:
Bearer
path Parameters
documentId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
Array of objects or null (UpsertDocumentAccessPolicyRequestItem)

Responses

Request samples

Content type
{
  • "accessPolicyItems": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve access policies for the specified metadata

Retrieves a list of access policy levels and their assigned access policy for a specified metadata.

Authorizations:
Bearer
path Parameters
metadataId
required
integer <int32>

The Metadata ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assign access policies for the specified metadata

Assign access policies to access-policy-levels for a specified metadata.

Authorizations:
Bearer
path Parameters
metadataId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
Array of objects or null (UpsertMetadataAccessPolicyRequestItem)

Responses

Request samples

Content type
{
  • "accessPolicies": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Link an associated entity to an existing segregated entity.

Links an associated entity to an existing segregated entity. Documents with the specified associated entity will be segregated according to the linked segregated entity.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
associatedEntityUid
string <uuid>
segregatedEntityUid
string <uuid>

Responses

Request samples

Content type
{
  • "associatedEntityUid": "20c927db-1f3e-4bd6-be8d-c626569916bc",
  • "segregatedEntityUid": "93245351-6fb1-4c54-ac0c-9a02143800cc"
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Link a new segregated entity to participants.

Links a new segregated entity to participants. Documents with associated entities linked to the specified segregated entity will be segregated according to the linked participants.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
segregatedEntityUid
string <uuid>
participantUids
Array of strings or null <uuid> [ items <uuid > ]

Responses

Request samples

Content type
{
  • "segregatedEntityUid": "93245351-6fb1-4c54-ac0c-9a02143800cc",
  • "participantUids": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

DocumentCategory

The Document Category API

Delete a document category

Deletes the document category specified by Id. If it is a parent document category it will also delete its children

Authorizations:
Bearer
path Parameters
categoryId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a list of document categories

Retrieves a list of document categories.

Authorizations:
Bearer
query Parameters
isActive
boolean
documentTypeId
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a document category

Creates a document category. An inactive category cannot be the parent of an active category.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
name
string or null
parentId
integer or null <int32>
dmsDocumentTypeId
integer <int32>
isActive
boolean or null

Responses

Request samples

Content type
{
  • "name": "string",
  • "parentId": 0,
  • "dmsDocumentTypeId": 0,
  • "isActive": true
}

Response samples

Content type
application/json
0
0

Retrieve a document category

Retrieves the document category specified by Id.

Authorizations:
Bearer
path Parameters
categoryId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "parentId": 0,
  • "dmsDocumentTypeId": 0,
  • "isActive": true,
  • "key": "string"
}

Update a document category

Updates the document category specified by Id. An inactive category cannot be the parent of an active category and cannot be assigned to an active metadata.

Authorizations:
Bearer
path Parameters
categoryId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
name
string or null
parentId
integer or null <int32>
dmsDocumentTypeId
integer <int32>
isActive
boolean or null

Responses

Request samples

Content type
{
  • "name": "string",
  • "parentId": 0,
  • "dmsDocumentTypeId": 0,
  • "isActive": true
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

DocumentMetadata

The Document Metadata API

Delete a document metadata

Deletes a metadata specified by Id.

Authorizations:
Bearer
path Parameters
metadataId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a metadata by Id

Retrieves a metadata by Id.

Authorizations:
Bearer
path Parameters
metadataId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "isMultiInstance": true,
  • "outputFilename": "string",
  • "documentReferenceId": "string",
  • "isActive": true,
  • "allowJointOwnership": true,
  • "documentCategory": {
    },
  • "documentType": {
    }
}

Update a document metadata

Updates the document metadata specified by Id. An inactive category cannot be assigned to an active metadata. Metadata may be inactivated even if there are active documents under it.

Authorizations:
Bearer
path Parameters
metadataId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
name
string or null
isMultiInstance
boolean
dmsDocumentCategoryId
integer <int32>
outputFilename
string or null
documentReferenceId
string or null
allowJointOwnership
boolean
isActive
boolean or null

Responses

Request samples

Content type
{
  • "name": "string",
  • "isMultiInstance": true,
  • "dmsDocumentCategoryId": 0,
  • "outputFilename": "string",
  • "documentReferenceId": "string",
  • "allowJointOwnership": true,
  • "isActive": true
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a metadata by MetadataReferenceId

Retrieves a metadata by MetadataReferenceId.

Authorizations:
Bearer
path Parameters
metadataReferenceId
required
string
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "isMultiInstance": true,
  • "outputFilename": "string",
  • "documentReferenceId": "string",
  • "isActive": true,
  • "allowJointOwnership": true,
  • "documentCategory": {
    },
  • "documentType": {
    }
}

Create a document metadata

Creates an active document metadata. An inactive category cannot be assigned to an active metadata.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
name
string or null
isMultiInstance
boolean
dmsDocumentCategoryId
integer <int32>
outputFilename
string or null
documentReferenceId
string or null
allowJointOwnership
boolean

Responses

Request samples

Content type
{
  • "name": "string",
  • "isMultiInstance": true,
  • "dmsDocumentCategoryId": 0,
  • "outputFilename": "string",
  • "documentReferenceId": "string",
  • "allowJointOwnership": true
}

Response samples

Content type
application/json
0
0

Lookup accessible document metadata

Lookup accessible document metadata by a given criteria.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The lookup criteria

documentType
string (DocumentType)
Enum: "Client" "General"
documentCategoryIds
Array of integers or null <int32> [ items <int32 > ]
documentMetadataName
string or null
isActive
boolean or null
metadataAccessPolicy
string (MetadataAccessPolicyFlag)
Enum: "Read" "Write" "Manage" "Any"

Responses

Request samples

Content type
{
  • "documentType": "Client",
  • "documentCategoryIds": [
    ],
  • "documentMetadataName": "string",
  • "isActive": true,
  • "metadataAccessPolicy": "Read"
}

Response samples

Content type
application/json
[
  • {
    }
]

Search through all document metadata

Searches through all document metadata by a given criteria.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
page
integer <int32>
pageSize
integer <int32>
sortBy
string or null
sortOrder
string (SortOrder)
Enum: "Ascending" "Descending"
searchTerm
string or null
searchMetadataBy
string (SearchMetadataBy)
Enum: "Name" "OutputFilename" "All"
documentTypeIds
Array of integers or null <int32> [ items <int32 > ]
documentCategoryIds
Array of integers or null <int32> [ items <int32 > ]
isActive
boolean or null

Responses

Request samples

Content type
{
  • "page": 0,
  • "pageSize": 0,
  • "sortBy": "string",
  • "sortOrder": "Ascending",
  • "searchTerm": "string",
  • "searchMetadataBy": "Name",
  • "documentTypeIds": [
    ],
  • "documentCategoryIds": [
    ],
  • "isActive": true
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "page": 0,
  • "pageSize": 0,
  • "pageCount": 0,
  • "totalCount": 0
}

DocumentSet

The Document Set API

Retrieve all document sets.

Retrieves all document sets.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

Create a document set

Creates a document set

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The document set to save

name
string or null
key
string or null
Array of objects or null (DocumentMetadata)

Responses

Request samples

Content type
{
  • "name": "string",
  • "key": "string",
  • "documentMetadata": [
    ]
}

Response samples

Content type
application/json
0
0

Retrieve document set

Retrieves document set

Authorizations:
Bearer
path Parameters
documentSetId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "key": "string",
  • "documentMetadata": [
    ]
}

Update a document set

Updates a document set

Authorizations:
Bearer
path Parameters
documentSetId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:
name
string or null
key
string or null
Array of objects or null (DocumentMetadata)

Responses

Request samples

Content type
{
  • "name": "string",
  • "key": "string",
  • "documentMetadata": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Validate whether a person owns active documents under all mandatory metadata listed in a specific document set

Validates whether a person owns active documents under all mandatory metadata listed in a specific document set. Only documents which the calling person or app had “READ“ access to are considered. If a contract is specified, the check would be performed only for documents which have this contract set for them. When returning information on unfulfilled metadatas, note that non-mandatory metadata will be returned as well.

Authorizations:
Bearer
path Parameters
ownerId
required
integer <int32>
documentSetId
required
integer <int32>
query Parameters
contractId
string <uuid>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "isFulfilled": true,
  • "unfulfilledMetadataIds": [
    ]
}

DocumentType

The Document Type API

Retrieve list of document types

Retrieves list of document types

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]