Api Documentation

Note

This section is under construction.

GET /Api/About/VersionInfo

Returns a version info record containing version number and build date.

Status Codes

  • 200 OK – About info record.

GET /Api/Account/GetAccountDetails

Gets the user details of the user associated with the current request.

Status Codes
POST /api/Account/SetAccountDetails

Processes a new user registration based on the provided information. This needs to include a valid captcha code. The user will be notified by e-mail containing a verification link. This link will have to be followed to verify the user’s mail address

Status Codes
POST /api/Account/Register

Processes a new user registration based on the provided information. This needs to include a valid captcha code. The user will be notified by e-mail containing a verification link. This link will have to be followed to verify the user’s mail address

Status Codes
GET /api/Account/EmailVerification

Verify the user by comparing the code to the verification code saved in the user’s PasswordQuestion field in asp.net membership. The user will receive an e-mail when the verification succeeds. The administrator of MCRA will receive an e-mail notifying the user’s registration

Query Parameters

  • userId (string, required) – The user’s name in ASP.NET membership

  • code (string, required) – The verification code

Status Codes
POST /api/Account/ResetPassword

Resets the user password. This needs to include a valid captcha code. The user is notified by e-mail when the password is changed successfully.

Status Codes
POST /api/Account/ChangeUserPassword

Changes a user’s password. The user is notified by e-mail when the password is changed successfully.

Status Codes
GET /api/ActionClasses/Get

Returns a collection of the action class definitions available in the toolbox.

Status Codes
GET /Api/Actions/GetAll/{idWorkspace}

Gets all actions of the workspace with the specified id.

Parameters

  • idWorkspace (integer:int32, required) – The id of the workspace.

Status Codes
GET /Api/Actions/Get/{id}

Gets the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
POST /Api/Actions/Create

Creates a new action action.

Status Codes
POST /Api/Actions/Clone

Duplicates an action and all of its settings and output.

Status Codes
POST /Api/Actions/UploadActionZipFile/{idWorkspace}

Creates an upload task that creates an action from an action+data zip file. Returns the task id for monitoring the progress.

Parameters

  • idWorkspace (integer:int32, required) – Id of the action that should be cloned.

Status Codes
DELETE /Api/Actions/Delete/{id}

Deletes the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action that should be deleted.

Status Codes
PUT /Api/Actions/UpdateMetaData/{id}

Updates the action meta data.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/ConvertToCustomAction/{id}

Converts the (standard)action to a custom action.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/UpdateStandardActionVersion/{id}

Updates the (standard)action to use the latest standard action version.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/SetIsCompute/{id}

Specifies whether the data of a (sub)module of the action should be computed or obtained from data.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/SetActionDataSource/{id}

Adds a data source to the data source configuration of the action.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/ReplaceActionDataSource/{id}

Replaces an action data source with another data source.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/GetSummary/{id}

Returns the summary of the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/GetDataReadingSummary/{id}

Returns the data reading summary of the specified (sub-)module for the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action.

Query Parameters

  • actionType (required) – The id of the (sub-)module

Status Codes
GET /Api/Actions/GetDataSelection/{id}

Retrieves a data entities page for the provided table.

Parameters

  • id (integer:int32, required) –

Query Parameters

  • entityType (required) –

Status Codes
GET /Api/Actions/GetDataReadingEntityRecords/{id}

Retrieves a data entities page for the provided table.

Parameters

  • id (integer:int32, required) –

Query Parameters

  • tableGroupId (required) –

  • scopingType (required) –

  • filteredStatusTypes (array) –

  • page (integer:int32) –

  • pageSize (integer:int32) –

  • sort (string) –

  • order (string) –

Status Codes
GET /Api/Actions/GetDataLinkingEntityRecords/{id}

Get action data linking records.

Parameters

  • id (integer:int32, required) –

Query Parameters

  • tableGroupId (required) –

  • scopingType (required) –

  • referencedScopingType (required) –

  • filteredStatusTypes (array) –

  • page (integer:int32) –

  • pageSize (integer:int32) –

  • sort (string) –

  • order (string) –

Status Codes
PUT /Api/Actions/SetScope/{id}

Sets the action scope. I.e., specify which data entities (specified by their codes) should be considered in the action.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/ClearScope/{id}

Clears the action scope/data selection.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/ExtendScope/{id}

Extends the action scope.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
PUT /Api/Actions/ReduceScope/{id}

Reduces the action scope.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/ExportActionSettings/{id}

Returns the settings xml of the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/ExportActionDataSources/{id}

Returns the data sources xml of the action with the specified id.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/DownloadActionZip/{id}

Returns all settings and data of the action as a zip-file. Project data is included in the form of csv files (zipped csv format).

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/DownloadActionZipOriginalData/{id}

Returns all settings and data of the action as a zip-file. Project data source files are included in their original forms.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /Api/Actions/DownloadActionZipNoData/{id}

Returns all settings and data source configuration of the action as a zip-file.

Parameters

  • id (integer:int32, required) – The id of the action.

Status Codes
GET /api/Actions/FileUploadProgress

Retrieves the task progress of the upload task with the specified task id.

Query Parameters

  • taskId (string, required) – The task id of the upload task.

Status Codes
GET /api/AdminUsers/GetUserStatuses
Status Codes
GET /api/AdminUsers/GetApprovedUserNames
Status Codes
GET /api/AdminUsers/GetUnverifiedUsers
Status Codes
POST /api/AdminUsers/DeleteUser
Status Codes
POST /api/AdminUsers/DeleteExpiredRegistrations
Status Codes
POST /api/AdminUsers/SetApprovalStatus
Status Codes
POST /api/AdminUsers/UpdateUser
Status Codes
POST /api/AdminUsers/UnlockUser
Status Codes
POST /api/AdminUsers/ResetPassword
Status Codes
GET /api/AdminRoles/GetAllRoles
Status Codes
POST /api/AdminRoles/Edit
Status Codes
POST /api/AdminRoles/Delete
Status Codes
POST /api/AdminRoles/Add
Status Codes
GET /api/AdminTasks/GetPagedTaskLogs

Gets the task-logs of the tasks run in the last 30 days at most.

Query Parameters

  • statuses (array) –

  • ownerFilter (string) –

  • endpointFilter (string) –

  • page (integer:int32) –

  • pageSize (integer:int32) –

  • fromDate (string:date-time) –

  • toDate (string:date-time) –

  • sort (string) –

  • order (string) –

Status Codes
POST /api/AdminTasks/CancelTaskLog
Status Codes
GET /Api/DataSources/Get/{id}

Returns a data source description record of the data source with the specified id.

Parameters

  • id (integer:int32, required) – The id of the data source.

Status Codes
GET /Api/DataSources/GetAll

Gets all data sources available to the user.

Status Codes
GET /Api/DataSources/GetRepositoryDataSources/{id}

Gets the data sources of the repository with the specified id.

Parameters

  • id (integer:int32, required) –

Status Codes
GET /Api/DataSources/GetRemoteRepositoryDataSources/{id}

Gets the data sources available in the remote repository with the specified id.

Parameters

  • id (integer:int32, required) –

Status Codes
POST /Api/DataSources/ImportRemoteDataSource

Imports the remote data source specified by the import settings.

Status Codes
PUT /Api/DataSources/Move/{id}

Moves the data source with the specified id to another repository.

Parameters

  • id (integer:int32, required) – The id of the data source that should be moved.

Status Codes
DELETE /Api/DataSources/Delete/{id}

Deletes the data source with the specified id.

Parameters

  • id (integer:int32, required) – The id of the data source that should be deleted.

Status Codes
PUT /Api/DataSources/Rename/{id}

Renames the data source with the specified id.

Parameters

  • id (integer:int32, required) – The id of the data source that is to be renamed.

Status Codes
POST /Api/DataSources/UploadNewDataSource/{idRepository}

Creates an upload task that adds a new data source to the repository with the specified id. Returns the task id for monitoring the progress.

Parameters

  • idRepository (integer:int32, required) – The id of repository in which the data source should be created.

Status Codes
POST /Api/DataSources/UploadNewDataSourceVersion/{idDataSource}

Creates an upload task that adds a new version to the specified data source. Returns the task id for monitoring the progress.

Parameters

  • idDataSource (integer:int32, required) – The id of data source for which this is a new version.

Status Codes
GET /Api/DataSources/GetVersion/{idVersion}

Gets the data source version with the specified id.

Parameters

  • idVersion (integer:int32, required) – The id of the data source version.

Status Codes
GET /Api/DataSources/GetVersions/{id}

Gets all versions of the data source with the specified id.

Parameters

  • id (integer:int32, required) – The id of the data source.

Status Codes
GET /Api/DataSources/GetWorkspaceDataSourceVersions/{idWorkspace}

Returns all data source versions used in the workspace with the specified id.

Parameters

  • idWorkspace (integer:int32, required) – The id of the workspace.

Status Codes
GET /Api/DataSources/GetDataSourceVersionUsage/{idVersion}

Returns the data source version’s usage in actions.

Parameters

  • idVersion (integer:int32, required) – The id of the version.

Status Codes
GET /Api/DataSources/GetDataSourceUsage/{idDataSource}

Returns the data source’s usage in actions.

Parameters

  • idDataSource (integer:int32, required) – The id of the data source.

Status Codes
GET /Api/DataSources/DownloadVersion/{idVersion}

Downloads the data source version dataset file of the version with the specified id.

Parameters

  • idVersion (integer:int32, required) –

Status Codes
GET /Api/DataSources/DownloadVersionCsv/{idVersion}

Downloads the data source version raw data (as imported by MCRA) of the version as zipped csv file collection.

Parameters

  • idVersion (integer:int32, required) –

Status Codes
POST /Api/DataSources/UploadActionZipFile

Creates an upload task that creates an action from an action+data zip file. Returns the task id for monitoring the progress.

Status Codes
GET /api/DataSources/FileUploadProgress

Retrieves the task progress of the upload task with the specified task id.

Query Parameters

  • taskId (string, required) – The task id of the upload task.

Status Codes
POST /Api/Messaging/SendMessage

Starts a calculation task for the given action and returns the id of this task.

Status Codes
GET /api/Repositories/GetAll
Status Codes
GET /Api/Repositories/Get/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
GET /Api/Repositories/GetDetails/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
POST /api/Repositories/Create
Status Codes
POST /api/Repositories/Update
Status Codes
POST /Api/Repositories/Delete/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
POST /Api/Repositories/ForceDelete/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
POST /api/Repositories/Move
Status Codes
POST /api/Repositories/ChangeOwner
Status Codes
POST /api/Repositories/AddUserShare
Status Codes
POST /api/Repositories/UpdateUserShare
Status Codes
POST /api/Repositories/RemoveUserShare
Status Codes
POST /api/Repositories/AddGroupShare
Status Codes
POST /api/Repositories/UpdateGroupShare
Status Codes
POST /api/Repositories/RemoveGroupShare
Status Codes
GET /Api/Repositories/GetRepositoryDataSourcesInUse/{id}

Gets the data sources that are in use in the repository with the specified id.

Parameters

  • id (integer:int32, required) –

Status Codes
GET /Api/Repositories/GetRepositoryDataSourceUsage/{id}

Gets all project information still associated with any datasources in the repository or any subrepositories

Parameters

  • id (integer:int32, required) – Id of the main repository to search

Status Codes
GET /api/UnitDefinitions/Get

Returns a collection of the unit definitions available in the toolbox.

Status Codes
GET /api/UserGroups/GetAll
Status Codes
GET /api/UserGroups/Search
Query Parameters

  • keyword (string, required) –

Status Codes
GET /Api/UserGroups/GetMembers/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
POST /api/UserGroups/Create
Status Codes
POST /Api/UserGroups/Delete/{id}
Parameters

  • id (integer:int32, required) –

Status Codes
POST /api/UserGroups/AddMember
Status Codes
POST /api/UserGroups/SetUserGroupName
Status Codes
POST /api/UserGroups/SetUserGroupPriority
Status Codes
POST /api/UserGroups/RemoveMember
Status Codes
POST /api/UserGroups/UpdateMembership
Status Codes
GET /Api/Users/GetCurrentUser

Gets the user details of the user associated with the current request.

Status Codes
GET /Api/Users/Search

Searches for the user using the specified keyword. Returns the top 5 matches..

Query Parameters

  • keyword (string, required) – The search keyword.

Status Codes

  • 200 OK – Records of the users associated with the specified keyword.

  • 401 Unauthorized – Authorization error.

GET /Api/Workspace/GetAll

Gets all workspaces available to the user.

Status Codes
GET /Api/Workspace/Get/{id}

Gets the workspace with the specified id.

Parameters

  • id (integer:int32, required) – The id of the workspace.

Status Codes
POST /Api/Workspace/Create

Creates a workspace based on the provided form data.

Status Codes
POST /Api/Workspace/Update/{id}

Updates the workspace meta data.

Parameters

  • id (integer:int32, required) – The id of the workspace that is to be updated.

Status Codes

  • 200 OK – A description record of the created workspace.

DELETE /Api/Workspace/Delete/{id}

Deletes the workspace with the specified id.

Parameters

  • id (integer:int32, required) – The id of the workspace that should be deleted.

Status Codes
GET /Api/Workspace/GetDataSources/{id}

Returns all data sources used in the workspace with the specified id.

Parameters

  • id (integer:int32, required) – The id of the workspace.

Status Codes
POST /Api/Workspace/AddDataSource/{id}

Adds a data source version to the workspace.

Parameters

  • id (integer:int32, required) – The id of the workspace.

Status Codes
POST /Api/Workspace/RemoveDataSource/{id}

Removes a data source version from the workspace.

Parameters

  • id (integer:int32, required) – The id of the workspace.

Status Codes