Show/Hide Toolbars

Therefore Web API Programming Interface 1.0

Therefore Web API > Web API Reference

List of Operations in Alphabetical Order

Scroll

Name

HTTP Method

Description

AddDictionaryKeyword

POST

Adds a new keyword to the keyword dictionary. Keyword dictionary can be located either by ByDictionaryID or by ByDictionaryTypeNo.

AddStreamsToDocument

POST

Adds file streams to an existing Thereforeā„¢ document. Conversion options for the documents can be specified.

ChangeUserPassword

POST

Changes password for the specified user.

CheckInDocument

POST

Checks in the updated document.

CheckOutDocument

POST

Checks out the document.

ClaimWorkflowInstance

POST

Claims the workflow instance.

ClearLocalCache

POST

Clear local WebAPI cache

ClearWorkflowInstanceErrors

POST

Clears the errors of given workflow instances.

CloseCase

POST

Closes the case with given case ID.

CompleteTask

POST

Completes the task with the specified task ID.

CopyEForm

POST

Copies an eForm and all related child objects

CreateCase

POST

Creates a new case, defines index data for the case and returns the case number.

CreateDocument

POST

Creates and archives a new Thereforeā„¢ document to a category as well as auto-append documents to existing ones; the operation can also be used to create a new document for the case (using a built-in CaseNo index data field).

CreateLinkFile

POST

Creates and returns a new Thereforeā„¢ compound file that contains a link to a Thereforeā„¢ document.

CreateNewManualLink

POST

Creates a the link between two documents/cases.

CreateUser

POST

Create new user.

CreateWorkflowUserInboxSubscription

POST

Creates a new workflow user inbox notification subscription.

DelegateWorkflowInstance

POST

Delegates the workflow instance to the specified user.

DeleteCase

POST

Deletes the case with the specified case number.

DeleteDashboard

POST

Saves or updates an Dashboard in Therefore.

DeleteDictionaryKeyword

POST

Deletes the keyword from the keyword dictionary. A keyword dictionary can be located either by ByDictionaryID or by ByDictionaryTypeNo.

DeleteDocument

POST

Deletes an existing Thereforeā„¢ document with the specified document number.

DeleteEForm

POST

Saves or updates an EForm in Therefore.

DeleteEFormDraftSubmission

POST

Delete an eForm draft in Therefore

DeleteFolder

POST

Delete a folder from Therefore

DeleteOfficeDocumentInCloud

POST

Deletes office document in the cloud.

DeletePortalUser

POST

Deletes given portal user.

DeleteTask

POST

Deletes the task with the specified task ID.

DeleteUserDashboards

POST

Deletes an user specific dashboard configuration

DeleteUserFavorites

POST

Deletes an user specific dashboard configuration

DeleteWorkflowInstance

POST

Deletes the workflow instance.

DisclaimWorkflowInstance

POST

Disclaims the current workflow instance if claimed by the current user.

EditOfficeDocumentInCloud

POST

Uploads given office document to the cloud for editing. Returns links to the uploaded file.

EraseAllObjects

POST

Erases deleted documents and cases from the system.

EraseObjects

POST

Erases specified objects from the system.

ExecuteAsyncFullTextQuery

POST

Starts "asynchronous" full text query. See also operations GetNextFullTextQueryRows and ReleaseFullTextQuery.

ExecuteAsyncMultiQuery

POST

Starts 'asynchronous' multi query. See also: operations GetNextMultiQueryRows and ReleaseMultiQuery. Multi query is used for searching and finding information across multiple categories with potentially different field selections, orders and conditions. FullText search string is one for all queries.

ExecuteAsyncSingleQuery

POST

Starts the 'asynchronous' single query. See also operations GetNextSingleQueryRows and ReleaseSingleQuery.

ExecuteDependentFieldsQuery

POST

Executes query for dependent field. Returns values from related referenced table.

ExecuteFullTextQuery

POST

Searches the contents of Thereforeā„¢ documents in one or more categories using information gathered by the Thereforeā„¢ indexing service.

ExecuteMultiQuery

POST

Executes queries in multiple categories.

ExecuteRecycleBinQuery

POST

Executes the query returning deleted Thereforeā„¢ documents and cases.

ExecuteReport

POST

Executes a report with given parameters.

ExecuteSimpleQuery

POST

Executes simple query on the server.

ExecuteSingleQuery

POST

Executes the single query on the server. Note (!): Set the Mode property of the query (for categoryes - NormalQuery(0), for Cases - CaseQuery(5), ...).

ExecuteStatisticsQuery

POST

Executes a request for statistical data of the system

ExecuteTaskInfoQuery

POST

Executes the query.

ExecuteUsersQuery

POST

Searches for users in Thereforeā„¢ and/or the Active Directory.

ExecuteWorkflowQueryForAll

POST

Executes a workflow query returning process information for all active processes.

ExecuteWorkflowQueryForProcess

POST

Executes the workflow query for given process on the server.

FillDependentFields

POST

If user-defined data types are used (foreign tables) this method will look up all referenced entries in foreign tables and fill in the dependent fields. If calculated fields exist this method will recalculate them. Updated index data fields are returned in response.

FinishCurrentWorkflowTask

POST

Finishes the current task, routes the workflow instance to NextTaskNo.

FinishedEditingOfficeDocumentInCloud

POST

Finishes editing for given office document in the cloud and returns file session id for the document.

GenerateWebRefererenceNo

POST

Generates encrypted web refernce number. Use it to encrypt the Thereforeā„¢ case, document, workflow instance, workflow process and task numbers for HTTP/HTTPS links used by Thereforeā„¢ Web Access.

GetAllTreeViews

POST

Gets a list of tree view items for specific permissions.

GetCase

POST

Gets the case with the specified case number.

GetCaseDefinition

POST

Gets the case definition from the server.

GetCaseDocuments

POST

Gets a list of document numbers contained in the case (and a specified category).

GetCaseHistory

POST

Returns the history of the case.

GetCategoriesTree

POST

Returns tree of the categories.

GetCategoryInfo

POST

Returns the definition of Thereforeā„¢ category.

GetClientDiscoveryInfo

POST

Loads discovery/connection information/settings from server

GetConnectedUser

POST

Returns information about connected user.

GetConnectionToken

POST

Returns connection token for provided user credentials.

GetConnectionTokenFromADFSToken

POST

Returns connection token for provided ADFS token.

GetConvertedDocStreams

POST

Returns file streams of existing Thereforeā„¢ document and converts them into the desired format.

GetConvertedDocStreamsRaw

POST

Returns file streams of existing Thereforeā„¢ document and converts them into the desired format. NOTE: If output of the conversion process contains many files only first file will be returned. If there are no streams in the document empty stream/array will be returned.

GetDashboard

POST

Saves or updates an Dashboard in Therefore.

GetDictionaryInfo

POST

Gets detailed information for the keyword dictionary. Keyword dictionary can be located either by ByDictionaryID or by ByDictionaryTypeNo.

GetDocument

POST

Returns the Thereforeā„¢ document from the server.

GetDocumentCheckoutStatus

POST

Returns check-out status of existing Thereforeā„¢ document.

GetDocumentHistory

POST

Returns the history of the specified Thereforeā„¢ document.

GetDocumentIndexData

POST

Returns index data of an existing Thereforeā„¢ document.

GetDocumentProperties

POST

Returns properties of existing Thereforeā„¢ document.

GetDocumentStream

POST

Returns the file stream of an existing Thereforeā„¢ document for any version of the document.

GetDocumentStreamFile

GET

Gets a file of a document by given document/version/stream numbers. Tenant Name or 'default' for a single tenant system. Document number. Document version number. Use 0 (zero) for latest version. Number of a file stream inside the document (zero based).

GetDocumentStreamRaw

POST

Returns the file stream of an existing Thereforeā„¢ document for any version of the document.

GetDomainInfo

POST

Gets the name of the default domain and a list of all valid domain names from the server.

GetEForm

POST

Loads an EForm from Therefore

GetEFormAccessToken

POST

Gets an anonymous access token to fill out an eForm

GetFieldsSaveUsageOrder

POST

Gets the order of fields used by the user when saving a new document to a category or creating a new case

GetFieldsSearchUsageOrder

POST

Gets the order of fields used by the user when searching a category/case definition

GetFolder

POST

Load information about a folder

GetJWTToken

POST

Returns JSON Web Token (JWT) for provided user credentials.

GetKeywordsByFieldNo

POST

Gets a list of keywords for the index data of the specified field.

GetKeywordsByKeyDic

POST

Gets a list of keywords for the keyword dictionary of the specified field.

GetLinkedObjects

POST

Gets a list of the objects linked to a given object.

GetLinkedWorkflowsForDoc

POST

Gets list of workflow for given document.

GetNextFullTextQueryRows

POST

Gets next portion of the data of a full text query started by ExecuteAsyncFullTextQuery operation. See also: ReleaseFullTextQuery.

GetNextMultiQueryRows

POST

Gets next portion of the data of multi query started by ExecuteAsyncMultiQuery operation. See also ReleaseMultiQuery.

GetNextSingleQueryRows

POST

Gets next portion of the data of a single query started by ExecuteAsyncSingleQuery operation. See also: ReleaseSingleQuery.

GetNotificationSubscriptions

POST

Gets all notification subscription guids for this user

GetObjectRights

POST

Gets the permissions of a specified object. Please see also operation GetPermissionConstants.

GetObjects

POST

Gets a list of a specified object from the server.

GetObjectsList

POST

Gets a list of a specified object from the server.

GetOfficeDocumentsInCloud

POST

Returns list of office documents uploaded to the cloud for given document number by current user.

GetPermissionConstants

POST

DEPRECATED: Use the GetRolePermissionConstants method instead. Gets a list of permission constants defined on the server.

GetPermissions

POST

DEPRECATED: Use the GetRolePermissions method instead. Gets the permission list directly set for the user on the specified object.

GetPublicSettingInt

POST

Gets the value of a integer public setting by the key.

GetPublicSettingString

POST

Gets the value of a string public setting by the key.

GetQuerySpecification

POST

Returns query specification: list of valid operators and operands, formats for dates and numbers.

GetReferencedTableInfo

POST

Get technical information about the table to query in Therefore

GetReportDefinition

POST

Gets the report definition by report definition number.

GetRoleAssignments

POST

Gets list of assignments of roles to users on one Thereforeā„¢ object.

GetRolePermissionConstants

POST

Gets a list of role-based permission constants defined on the server.

GetRolePermissions

POST

Gets the role-based permissions set for the connected user on the specified object. See also: operation GetRolePermissionConstants.

GetRoles

POST

Gets list of roles.

GetSavedQuery

POST

Gets saved query (search). The Query object returned in response can be used in the ExecuteSingleQuery request (as it is or with changes).

GetSettingInt

POST

Gets the value of integer setting by the key.

GetSettingString

POST

Gets the value of a string setting by the key.

GetSmartCaptureVerficationLink

POST

Gets a verification url/link for a document being processed in Capture AI

GetSystemCustomerId

GET

Get the customer Id of the currently connected system

GetTask

POST

Gets the Task details by task number.

GetTaskInfo

POST

Gets the TaskInfo details by task number.

GetThumbnail

POST

Returns the thumbnail of an existing Thereforeā„¢ document.

GetTreeViewChildNodes

POST

Gets child nodes of a given tree view

GetTreeViewChildNodesAndDocuments

POST

Gets child nodes and documents of a given tree view

GetTreeViewNodeDocuments

POST

Gets document nodes of given tree view.

GetUploadedEFormFile

GET

Get a previously saved eForm attachment file for viewing Tenant name Field Id

GetUserDashboards

POST

Loads an user specific dashboard configuration

GetUserDetails

POST

Returns details about user or group with the specified ID.

GetUserFavorites

POST

Loads user specific favorites

GetUserGroupNo

POST

Adds a domain user to Thereforeā„¢ and gets number of the user.

GetUsersFromGroup

POST

Get list of users from given group.

GetViewingPages

POST

Gets the number of pages in a document for viewing

GetViewingThumbnails

POST

Gets the thumbnails for specified streams of a document or for a file from the upload session

GetWebAPIServerVersion

POST

Gets the current version of the Web API server.

GetWorkflowInstance

POST

Gets the workflow instance by number.

GetWorkflowProcess

POST

Gets the workflow process by number.

GetWorkflowTaskSettings

POST

Gets list of given settings of the workflow task.

HandleESignaturePushNotification

POST

Handles the push notification from the eSignature service and forwards it to the server.

HasPermissions

POST

Checks if the currently logged on user has the specified permission(s) for the specified object.

HasRolePermission

POST

Checks if the currently logged on user has the specified role permission for the specified object.

LinkCases

POST

DEPRECATED: Use the CreateNewManualLink method instead. Creates the link between two cases.

LinkCaseToDocument

POST

Creates new link between a document and a case.

LinkDocAndWFInstance

POST

Creates the link between the document and the workflow instance.

LinkDocuments

POST

DEPRECATED: Use the CreateNewManualLink method instead. Creates the link between two documents.

MoveUserLicense

POST

Moves license of authenticated user from other node to current node.

PrepareViewing

POST

Prepares viewing/conversion of a document to html5

PreprocessIndexData

POST

Returns index data for given category (with default values, filled dependent fields, or with ix data for autoappend, and updated calculated fields).

PreprocessTableRow

POST

Returns index data for given table row (with default values, filled dependent fields).

QueryDependentFieldsDirect

POST

Search Therefore database table for content

RefreshNotificationSubscriptions

POST

Refreshes existing notification subscriptions.

ReleaseFullTextQuery

POST

Releases a full text query when all data is taken or is no more needed. See also: ExecuteAsyncFullTextQuery and GetNextFullTextQueryRows operations.

ReleaseMultiQuery

POST

Releases multi query when all data is taken or is no more needed. See also: ExecuteAsyncMultiQuery and GetNextMultiQueryRows operations.

ReleaseSingleQuery

POST

Releases single query when all data is taken or is no more needed. See also: ExecuteAsyncSingleQuery and GetNextSingleQueryRows operations.

RemoveManualLink

POST

Creates a the link between two documents/cases.

RemoveNotificationSubscriptions

POST

Removes existing notification subscriptions.

RenameObject

POST

Rename an object in Therefore

ReopenCase

POST

Reopens a closed case.

ResetUserPwd

POST

Triggers the forgot password functionality.

RevertEditedOfficeDocumentsInCloud

POST

Reverts any changes made to the given office document and deletes it in the cloud if any.

SaveCaseIndexData

POST

Updates the case index data.

SaveCaseIndexDataQuick

POST

Updates index data of an existing Thereforeā„¢ case quickly, without specifying LastChangeTime. This method allows to update any index data fields except table fields. Updating the table fields without specifying LastChangeTime is unsafe.

SaveDashboard

POST

Saves or updates an Dashboard in Therefore.

SaveDocumentIndexData

POST

Updates index data of an existing Thereforeā„¢ document.

SaveDocumentIndexDataQuick

POST

Updates index data of an existing Thereforeā„¢ document quickly, without specifying LastChangeTime. This method allows to update any index data fields except table fields. Updating the table fields without specifying LastChangeTime is unsafe.

SaveEForm

POST

Saves or updates an EForm in Therefore.

SaveEFormDefaultSubmission

POST

Save default submission data for an eForm

SaveEFormDraft

POST

Save an eForm draft to Therefore

SaveFolder

POST

Save a new folder to Therefore

SavePortalUser

POST

Saves or updates given portal user.

SaveUserDashboards

POST

Saves or updates an user specific dashboard configuration

SaveUserFavorites

POST

Saves or updates an user specific favorites

SearchEFormSubmission

POST

Search saved eForm submissions for current user

SetChecklistItemWorkflow

POST

Sets the checked status for the specified checklist item.

SetParentFolder

POST

Move a folder to another parent folder

SetPermissions

POST

Sets permissions for the user on the specified object.

SetTaskStatus

POST

Changes the status of the task.

SetTextInfoWorkflow

POST

Sets the free text information for the workflow instance.

SetUserPassword

POST

Sets an (internal) users password

SignOut

POST

Releases license of authenticated user on current node.

StartCreateDocumentBatch

POST

Starts a batch operation to create and archive a new Thereforeā„¢ document.

StartTask

POST

DEPRECATED: use the StartTask2 method instead. Starts a new task.

StartTask2

POST

Starts a new task.

StartUpdateDocumentBatch

POST

Starts a batch operation to update a Thereforeā„¢ document.

StartViewingSession

POST

Starts a viewing session for a specified document stream or for a file from the upload session. Also creates a thumbnail if required.

StartWorkflowInstance

POST

Starts a workflow instance.

StopViewingSession

POST

Stops a viewing session for a specified document stream or for a file from the upload session. This helps freeing up resources.

SubmitCreateDocumentBatch

POST

Submits an operation to create and archive a new Thereforeā„¢ document.

SubmitEForm

POST

Loads an EForm from Therefore

SubmitUpdateDocumentBatch

POST

Submits an operation to update a Thereforeā„¢ document.

TestCheckOutDocument

POST

Tests if check out is possible for given document.

UndoCheckOutDocument

POST

Frees the locked document so that other users may check it out. All changes are lost.

UnlinkCases

POST

DEPRECATED: Use the RemoveManualLink method instead. Removes the link between two cases.

UnlinkDocAndWFInstance

POST

Removes the document link to a Thereforeā„¢ document from the workflow instance.

UnlinkDocuments

POST

DEPRECATED: Use the RemoveManualLink method instead. Removes the link between two documents.

UpdateDictionaryKeyword

POST

Updates the keyword name and/or activated status in the keyword dictionary. Keyword dictionary can be located either by ByDictionaryID or by ByDictionaryTypeNo.

UpdateDocument

POST

Updates an existing Thereforeā„¢ document.

UpdateRoleAssignments

POST

Disables or enables inheritance and updates/deletes role assignments for users on one Thereforeā„¢ object.

UpdateTask

POST

DEPRECATED: use the UpdateTask2 method instead. Saves changes to the Task with the specified task ID.

UpdateTask2

POST

Saves changes to the Task with the specified task ID.

UpdateTaskComment

POST

Sets the comment of the task.

UpdateUserGroupAssignment

POST

Updates (adds/removes) assignments of the given user to the given Therefore groups.

UploadDocStreamToBatch

POST

Uploads a file for a given batch operation.

UploadEFormFile

POST

Upload a file to be saved as attachment to an eForm. HTTP header param: x-the-name.

UploadSessionAppendChunkRaw

POST

Uploads chunked data (in the body of the request as Content-Type: application/octet-stream) for the file associated with the given upload session. Accepts following mandatory HTTP headers: X-The-UploadSession-ChunkPosition, X-The-UploadSession-Id.

UploadSessionStart

POST

Starts a chunk upload session for a single file to create and archive a new Thereforeā„¢ document.

ValidateFields

POST


ValidateKeywords

POST

Validates keywords for a specified index data field.

VerifyReCaptchaToken

POST

Returns information about connected user.

 

Ā© 2023 Therefore Corporation, all rights reserved.