- 09 Oct 2024
- 10 Minutes to read
- DarkLight
Methods
- Updated on 09 Oct 2024
- 10 Minutes to read
- DarkLight
General
This page lists all available API methods and describes their parameters and return values.
CopyWorkspace
This method requires an HTTP POST and copies an existing Workspace and all its contents to a newly created workspace. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Workspace to be copied. |
The name of the copied workspace. | The name of the copied workspace. |
The call returns a SuccessStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call copies the Workspace with ID aa6ffd4e-dc24-4ddb-8bb8-db494c31ea6f and gives the newly created workspace the name MyWorkspaceCopy:
http(s)://<host>:<port>/Api/?Method=CopyWorkspace&Id=aa6ffd4e-dc24-4ddb-8bb8-db494c31ea6f&CopiedWorkspaceName=MyWorkspaceCopy
Delete
This method requires an HTTP DELETE and deletes the entity with the given ID. It has the following parameters:
Name | Description |
---|---|
Id | The ID of the entity to delete. |
The call returns a SuccessStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call deletes the entity with ID 3388b658-1baf-4058-abd1-44edecdad4c3:
http(s)://<host>:<port>/Api/?Method=Delete&Id=3388b658-1baf-4058-abd1-44edecdad4c3
ExecuteTask
This method requires an HTTP POST and executes the Task with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Task to be executed. |
Delay | An optional delay in seconds. |
Parameters | An optional query parameter that can contain one or more task parameters. An example is *Country:Austria;Germany |
The call waits until the execution has finished and returns the ExecutionResultStructure.
Example
The following call executes the Task with ID 3388b658-1baf-4058-abd1-44edecdad4c3.
http(s)://<host>:<port>/Api/?Method=ExecuteTask&TaskId=3388b658-1baf-4058-abd1-44edecdad4c3
ExecuteTaskAsync
This method requires an HTTP POST and executes the Task with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Task to be executed. |
Delay | An optional delay in seconds. |
Parameters | An optional query parameter that can contain one or more task parameters. An example is *Country:Austria;Germany |
The call immediately returns a GuidStructure that contains the ID of the request which can be used in a GetRequestExecutionStatus method to poll the status of the execution.
Example
The following call executes the Task with ID 3388b658-1baf-4058-abd1-44edecdad4c3.
http(s)://<host>:<port>/Api/?Method=ExecuteTaskAsync&TaskId=3388b658-1baf-4058-abd1-44edecdad4c3
GetAlert
This method requires an HTTP GET and returns the AlertStructure that represents the Alert with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Alert to be returned. |
The call returns the requested AlertStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an AlertStructure that represents the Alert with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetAlert&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetAlerts
This method requires an HTTP GET and returns an InteropStructureCollection that contains AlertStructures representing the queried Alerts. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter Alerts by their name. This parameter is optional. |
WorkspaceId | The ID of the Workspace in which to query Alerts. This parameter is optional. |
WorkspaceName | The ID of the Workspace in which to query Alerts. This parameter is optional. |
UserId | The ID of the Workspace in which to query Alerts. This parameter is optional. |
UserName | The name of the User whose Alerts to query. This parameter is optional. |
DatasourceID | The ID of the Datasource whose associated Alerts to query. This parameter is optional. |
DatasourceName | The name of the Datasource whose associated Alerts to query. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested AlertStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing AlertStructures of all Alerts that belong to the User with ID 24e68134-9e23-429e-9f46-30ca1921460c in the Workspace named MyWorkspace:
http(s)://<host>:<port>/Api/?Method=GetAlerts&UserId=24e68134-9e23-429e-9f46-30ca1921460c&WorkspaceName=MyWorkspace
GetAuthenticatedUser
This method requires an HTTP GET and returns a UserStructure that represents the User that performs the API call. There are no parameters.
GetBackupConfiguration
This method requires an HTTP GET and returns the BackupConfigurationStructure that represents the current Backup Settings. The call returns the requested BackupConfigurationStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns the BackupConfigurationStructure:
http(s)://<host>:<port>/Api/?Method=GetBackupConfiguration
GetDataExchangeConfiguration
This method requires an HTTP GET and returns the DataExchangeConfigurationStructure that represents the current Data Exchange Settings. The call returns the requested DataExchangeConfigurationStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns the DataExchangeConfigurationStructure:
http(s)://<host>:<port>/Api/?Method=GetDataExchangeConfiguration
GetDatasource
This method requires an HTTP GET and returns the DatasourceStructure that represents the Datasource with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Datasource to be returned. |
The call returns the requested DatasourceStructure if everything worked as expected or an ExceptionStr**ucture if an error occured.
Example
The following call returns a DatasourceStructure that represents the Datasource with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
:::(Info)(GetDatasource API Call)
http(s)://<host>:<port>/Api/?Method=GetDatasource&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
:::
GetDatasources
This method requires an HTTP GET and returns an InteropStructureCollection that contains DatasourceStructures representing the queried Datasources. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter Datasources by their name. This parameter is optional. |
WorkspaceId | The ID of the Workspace in which to query Datasources. This parameter is optional. |
WorkspaceId | The name of the Workspace in which to query Datasources. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested DatasourceStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing DatasourceStructures of all Datasources that belong to the Workspace named MyWorkspace:
http(s)://<host>:<port>/Api/?Method=GetDatasources&WorkspaceName=MyWorkspace
GetDeploymentConfiguration
This method requires an HTTP GET and returns the DeploymentConfigurationStructure that represents the current Deployment Settings. The call returns the requested DeploymentConfigurationStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns the DeploymentConfigurationStructure:
http(s)://<host>:<port>/Api/?Method=GetDeploymentConfiguration
GetEMailServers
This method requires an HTTP GET and returns an InteropStructureCollection that contains EMailServerStructures representing the queried E-Mail Servers. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter E-Mail Servers by their name. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested EMailServerStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing EMailServerStructures of all E-Mail Servers whose name start with Def:
http(s)://<host>:<port>/Api/?Method=GetEMailServers&NamePattern=^Def.*
GetReport
This method requires an HTTP GET and returns the ReportStructure that represents the Report with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Report to be returned. |
The call returns the requested ReportStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns a ReportStructure that represents the Report with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetReport&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetReports
This method requires an HTTP GET and returns an InteropStructureCollection that contains ReportStructures representing the queried Reports. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter Reports by their name. This parameter is optional. |
WorkspaceId | The ID of the Workspace in which to query Reporst. This parameter is optional. |
WorkspaceName | The name of the Workspace in which to query Reports. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested ReportStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing ReportStructures of all Reports that belong to the Workspace named MyWorkspace:
http(s)://<host>:<port>/Api/?Method=GetReports&WorkspaceName=MyWorkspace
GetReportSupportedFileTypes
This method requires an HTTP GET and returns an InteropStructureCollection that contains FileTypeStructures for all output file types supported by a Report with a given ID. It has the following parameters:
Name | Description |
---|---|
ReportId | The ID of the Report for which to return supported output file types. |
Example
The following call returns an InteropStructureCollection containing FileTypeStructures for supported output file types of the Report with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetReportSupportedFileTypes&ReportId=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetSelfServiceReports
This method requires an HTTP GET and returns an InteropStructureCollection that contains ReportStructures representing Reports to which the User with the given ID has required Authorizations to request the report. It only returns reports within the Workspace with the given ID- It has the following parameters:
Name | Description |
---|---|
UserId | The ID of the User whose self-service Reports to return. |
WorkspaceId | The ID of the Workspace in which to query Reports. |
The call returns an InteropStructureCollection containing the requested ReportStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing ReportStructures of all Reports that belong to the Workspace with ID f11f7c91-5c5d-4eb0-9a64-c34f04954615 for which the User with ID 4e4ff28a-d22e-4484-be08-4593875f17ff has required Authorizations to request the report:
http(s)://<host>:<port>/Api/?Method=GetSelfServiceReports&UserId=4e4ff28a-d22e-4484-be08-4593875f17ff&WorkspaceId=f11f7c91-5c5d-4eb0-9a64-c34f04954615
GetTask
This method requires an HTTP GET and returns the TaskStructure that represents the Task with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Task to be returned. |
The call returns the requested TaskStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns a TaskStructure that represents the Task with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetTask&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetTasks
This method requires an HTTP GET and returns an InteropStructureCollection that contains TaskStructures representing the queried Tasks. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter Tasks by their name. This parameter is optional. |
WorkspaceId | The ID of the Workspace in which to query Tasks. This parameter is optional. |
WorkspaceName | The name of the Workspace in which to query Tasks. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested TaskStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing TaskStructures of all Tasks that belong to the Workspace named MyWorkspace:
http(s)://<host>:<port>/Api/?Method=GetTasks&WorkspaceName=MyWorkspace
GetRequest
This method requires an HTTP GET and returns the RequestStructure with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the request to be returned. |
The call returns the requested RequestStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns a RequestStructure that represents the request with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
:::(Info)(GetRequest API Call)
http(s)://<host>:<port>/Api/?Method=GetRequest&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
:::
GetRequestExecutionStatus
This method requires an HTTP GET and returns the ExecutionStatusStructure for the request with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the request whose ExecutionStatusStructure to return. |
The call returns the requested ExecutionStatusStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns a ExecutionStatusStructure of the request with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetRequestExecutionStructure&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetUser
This method requires an HTTP GET and returns the UserStructure that represents the User with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the User to be returned. |
The call returns the requested UserStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an UserStructure that represents the User with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetUser&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetUsers
This method requires an HTTP GET and returns an InteropStructureCollection that contains UserStructures representing the queried Users. It has the following parameters:
Name | Description |
---|---|
Description | A regular expression used to filter Users by their name. This parameter is optional. |
EMailAddress | The e-mail address of Users to return. This parameter is optional. |
CustomUsername | The e-mail address of Users to return. This parameter is optional. |
CustomUsername | The windows account name of Users to return. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested UserStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing UserStructures of all Users with an e-mail address of user@company.com:
http(s)://<host>:<port>/Api/?Method=GetUsers&EMailAddress=user%40company.com
GetWorkspace
This method requires an HTTP GET and returns the WorkspaceStructure that represents the Workspace with a given ID. It has the following properties:
Name | Description |
---|---|
Id | The ID of the Workspace to be returned. |
The call returns the requested WorkspaceStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an WorkspaceStructure that represents the Workspace with ID c81c3676-bc73-432b-b82e-a09b6b8d5777:
http(s)://<host>:<port>/Api/?Method=GetWorkspace&Id=c81c3676-bc73-432b-b82e-a09b6b8d5777
GetWorkspaces
This method requires an HTTP GET and returns an InteropStructureCollection that contains WorkspaceStructures representing the queried Workspaces. It has the following parameters:
Name | Description |
---|---|
NamePattern | A regular expression used to filter Workspaces by their name. This parameter is optional. |
The call returns an InteropStructureCollection containing the requested WorkspaceStructures if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call returns an InteropStructureCollection containing WorkspaceStructures of all Workspaces with a name that starts with R:
http(s)://<host>:<port>/Api/?Method=GetWorkspaces&NamePattern=%5ER
Persist
This method requires an HTTP POST and persists the InteropStructure supplied as POST data to the request. The call returns a SuccessStructure if everything worked as expected or an ExceptionStructure if an error occured.
RebuildDatasourceCache
This method requires an HTTP POST and rebuilds the cache of the Datasource with the given ID. It has the following parameters:
Name | Description |
---|---|
Id | The ID of the Datasource whose cache to rebuild. |
The call returns a SuccessStructure if everything worked as expected or an ExceptionStructure if an error occured.
Example
The following call rebuilds the cache of the Datasource with ID 3388b658-1baf-4058-abd1-44edecdad4c3:
http(s)://