testops-api
Katalon TestOps API reference
- API version: 1.0.0
No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
Automatically generated by the OpenAPI Generator
Requirements
Building the API client library requires:
- Java 1.8+
- Maven/Gradle
Installation
To install the API client library to your local Maven repository, simply execute:
mvn clean install
To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
mvn clean deploy
Refer to the OSSRH Guide for more information.
Maven users
Add this dependency to your project's POM:
<dependency>
<groupId>com.katalon</groupId>
<artifactId>testops-api</artifactId>
<version>0.0.1-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
Gradle users
Add this dependency to your project's build file:
compile "com.katalon:testops-api:0.0.1-SNAPSHOT"
Others
At first generate the JAR by executing:
mvn clean package
Then manually install the following JARs:
target/testops-api-0.0.1-SNAPSHOT.jartarget/lib/*.jar
Getting Started
Please follow the installation instruction and execute the following Java code:
import com.katalon.testops.api.*;
import com.katalon.testops.api.auth.*;
import com.katalon.testops.api.model.*;
import com.katalon.testops.api.api.AgentApi;
public class AgentApiExample {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("http://localhost:8443");
// Configure HTTP basic authorization: basicScheme
HttpBasicAuth basicScheme = (HttpBasicAuth) defaultClient.getAuthentication("basicScheme");
basicScheme.setUsername("YOUR USERNAME");
basicScheme.setPassword("YOUR PASSWORD");
AgentApi apiInstance = new AgentApi(defaultClient);
AgentResource agentResource = new AgentResource(); // AgentResource |
try {
AgentResource result = apiInstance.create(agentResource);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling AgentApi#create");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Documentation for API Endpoints
All URIs are relative to http://localhost:8443
| Class | Method | HTTP request | Description |
|---|---|---|---|
| AgentApi | create | POST /api/v1/agent | Creates or updates a Local agent. Returns the agent detail. |
| AgentApi | create4 | POST /api/v1/circle-ci-agent | Creates a new CircleCI agent. Returns the created agent detail. |
| AgentApi | create5 | POST /api/v1/k8s-agent | Creates a K8S agent. Returns the created agent detail. |
| AgentApi | delete | DELETE /api/v1/agent/{id} | Deletes a Local agent. Returns the deleted agent detail. |
| AgentApi | generateAgent | GET /api/v1/agent | Generates the configuration file for the Local agent. Returns the configuration file. |
| AgentApi | get | GET /api/v1/agent/{id} | Get a Local agent. Returns the agent detail. |
| AgentApi | get11 | GET /api/v1/circle-ci-agent/{id} | Returns a CircleCI agent detail. |
| AgentApi | get13 | GET /api/v1/k8s-agent/{id} | Returns a K8S agent detail. |
| AgentApi | getFollowedProjects | POST /api/v1/circle-ci-agent/projects | |
| AgentApi | update6 | PUT /api/v1/circle-ci-agent | Updates a CircleCI agent detail. Returns the updated agent detail. |
| AgentApi | update7 | PUT /api/v1/k8s-agent | Updates a K8S agent detail. Returns the updated agent detail. |
| AgentApi | updateThreshold | PUT /api/v1/agent/threshold | Updates the threshold for Local agent. Returns the agent detail. |
| CommentApi | create1 | POST /api/v1/comments | Creates a Comment. Returns the created Comment detail. |
| CommentApi | update | PUT /api/v1/comments | Updates a Comment detail. Returns the updated Comment detail. |
| ExecutionApi | bulkDownload | GET /api/v1/executions/download | Exports and downloads multiple Executions. Returns the archive file comprising the Execution summaries. |
| ExecutionApi | delete1 | DELETE /api/v1/executions | Deletes multiple Executions. Returns the deleted Execution details. |
| ExecutionApi | download1 | GET /api/v1/executions/{id}/download | Exports and downloads an Execution. Returns the Execution summary file. |
| ExecutionApi | downloadFile | GET /api/v1/executions/{id}/download-file | Downloads all uploaded files of an Execution. Returns the archive file comprising all Execution's files. |
| ExecutionApi | get1 | GET /api/v1/executions/{id} | Returns an Execution detail. |
| ExecutionApi | getLatestExecutions | GET /api/v1/organizations/{id}/latest-executions | |
| ExecutionApi | linkRelease | POST /api/v1/executions/{id}/link-release | Link an Execution to a Release. Returns the updated Execution detail. |
| ExecutionApi | list | GET /api/v1/executions | |
| ExecutionApi | reImportExecution | POST /api/v1/executions/reimport | Re-imports an Execution. Returns the newly imported Execution detail. |
| ExecutionApi | rerunExecution | POST /api/v1/executions/{id}/rerun | Rerun an Execution. |
| ExecutionApi | shareExecutionReport | POST /api/v1/executions/{id}/share-report | Allow users to send email with attached execution reports [PDF]. |
| ExecutionApi | terminatedExecution | POST /api/v1/executions/terminate | Terminates a running Execution. Returns the terminated Execution detail. |
| ExecutionApi | unlinkRelease | POST /api/v1/executions/{id}/unlink-release | Unlink an Execution to a Release. Returns the updated Execution detail. |
| ExecutionRequestApi | download | GET /api/v1/requests/{id}/download | Downloads an Execution Request report. Returns the report file. |
| ExecutionRequestApi | getExecutionRequest | GET /api/v1/requests/{id} | Returns an Execution Request detail. |
| ExecutionTestResultApi | get2 | GET /api/v1/test-results/{id} | Returns an Execution Test Result detail. |
| ExecutionTestResultApi | getStdout | GET /api/v1/test-results/logs/{id} | Downloads a test result's log. Returns the log file. |
| ExecutionTestResultApi | linkIncidents | POST /api/v1/test-results/{id}/incidents | Link an Execution Test Result to a Task. Returns the created binding detail. |
| ExecutionTestResultApi | markAsRetested | POST /api/v1/test-results/{id}/mask-as-retested | |
| ExecutionTestResultApi | unlinkIncidents | DELETE /api/v1/test-results/{id}/incidents | Unlink an Execution Test Result to a Task. Returns the deleted binding detail. |
| ExecutionTestSuiteApi | get3 | GET /api/v1/execution-test-suites/{id} | Returns an Execution Test Suite detail. |
| FileApi | download2 | GET /api/v1/files/{id} | Downloads a file. |
| FileApi | getUploadUrl | GET /api/v1/files/upload-url | Returns an upload URL. |
| FileApi | getUploadUrls | GET /api/v1/files/upload-urls | Returns multiple upload URLs. |
| JobApi | cancel | DELETE /api/v1/jobs/{id} | Cancels a Job. |
| JobApi | get12 | GET /api/v1/jobs/{id} | Returns a Job detail. |
| JobApi | getJob | GET /api/v1/jobs/get-job | Returns the next queued Job of an Agent. |
| JobApi | getLatestJobs | GET /api/v1/organizations/{id}/latest-jobs | |
| JobApi | getLog | GET /api/v1/jobs/{id}/get-log | Returns a Job's log. |
| JobApi | getRunningJobs | GET /api/v1/organizations/{id}/running-jobs | |
| JobApi | updateJob | POST /api/v1/jobs/update-job | Updates a Job detail. Returns the updated Job detail. |
| KatalonRecorderApi | backup | POST /api/v1/katalon-recorder/backup | Saves a Katalon Recorder backup detail. |
| KatalonRecorderApi | download3 | GET /api/v1/katalon-recorder/backup/{id}/download | Downloads a Katalon Recorder backup. Returns the backup file. |
| KatalonRecorderApi | upload | POST /api/v1/katalon-recorder/test-reports | Uploads and processes a Katalon Recorder report. |
| OrganizationTrialRequestResourceControllerApi | getTrialRequest | GET /api/v1/organizations/{id}/trial-request | Get organization trial request data |
| OrganizationTrialRequestResourceControllerApi | submitTrialRequest | POST /api/v1/organizations/{id}/trial-request | Submit organization trial request |
| ProjectApi | create2 | POST /api/v1/projects | Creates a new Project. Returns the created Project detail. |
| ProjectApi | createOrUpdate | POST /api/v1/project-settings | |
| ProjectApi | createSampleData | POST /api/v1/projects/{id}/sample-data | Create sample data for project. |
| ProjectApi | delete2 | DELETE /api/v1/projects/{id} | Deletes a Project. Returns the deleted Project detail. |
| ProjectApi | get5 | GET /api/v1/projects/{id} | Returns a Project detail. |
| ProjectApi | get6 | GET /api/v1/project-settings/{id} | |
| ProjectApi | list1 | GET /api/v1/projects | Returns all Projects of a Team. |
| ProjectApi | update2 | PUT /api/v1/projects | Updates a Project detail. Returns the updated Project detail. |
| ProjectApi | updateStatus | PUT /api/v1/projects/update-status | Updates a Project status. Returns the updated Project detail. |
| ProjectConfigurationResourceControllerApi | get14 | GET /api/v1/project-configurations/{id} | |
| ProjectConfigurationResourceControllerApi | listTimeZones | GET /api/v1/time-zones | |
| ProjectConfigurationResourceControllerApi | update8 | POST /api/v1/project-configurations/{id} | |
| ReleaseApi | activeRelease | POST /api/v1/releases/{id}/active | Open or close a Release. Returns the updated Release detail. |
| ReleaseApi | createOrUpdate1 | POST /api/v1/releases | Creates or updates a Release. Returns the Release details. |
| ReleaseApi | delete3 | DELETE /api/v1/releases/{id} | Deletes a Release. Returns the Release details. |
| ReleaseApi | update3 | PUT /api/v1/releases | Updates a Release. Returns the Release details. |
| SearchApi | search | GET /api/v1/search | Queries the resources of a specific type by multiple conditions. Returns the pageable resources satisfying the query. |
| SearchApi | search1 | POST /api/v1/search | Queries the resources of a specific type by multiple conditions. Returns the pageable resources satisfying the query. |
| SearchApi | test | GET /api/v1/search/info | Returns the search configuration. |
| TaskApi | createIncident | POST /api/v1/incidents | Creates a Task for the test results. Returns the created Task detail. |
| TaskApi | get4 | GET /api/v1/incidents/{id} | Returns a Task detail. |
| TaskApi | update1 | PUT /api/v1/incidents | Updates a Task detail. Returns the updated Task detail. |
| TeamApi | create3 | POST /api/v1/teams | Creates a new Team. Returns the created Team detail. |
| TeamApi | delete4 | DELETE /api/v1/teams/{id} | Delete a Team. Returns the delete Team detail. |
| TeamApi | get7 | GET /api/v1/teams/{id} | Returns a Team detail. |
| TeamApi | list2 | GET /api/v1/teams | Returns all Teams of the current User. |
| TeamApi | update4 | PUT /api/v1/teams | Updates a Team detail. Returns the updated Team detail. |
| TeamApi | updateUserTeam | PUT /api/v1/permission/team/user | Updates the role of a User in a Team. Returns the updated detail. |
| TestCaseApi | get8 | GET /api/v1/test-cases/{id} | Returns a Test Case detail. |
| TestCaseApi | update5 | POST /api/v1/test-cases/update | Update a Test Case. |
| TestObjectApi | get15 | GET /api/v1/test-object-entities/{id} | Returns a Test Object detail. |
| TestPlanApi | createAndTriggerSample | POST /api/v1/run-configurations/sample | Creates and triggers a sample Test Plan. Returns the created Test Plan detail. |
| TestPlanApi | createOrUpdateConfiguration | POST /api/v1/run-configurations | Creates or updates a Test Plan. Returns the Test Plan detail. |
| TestPlanApi | delete5 | DELETE /api/v1/run-configurations/{id} | Deletes a Test Plan. Returns the deleted Test Plan detail. |
| TestPlanApi | linkRelease1 | POST /api/v1/run-configurations/{id}/link-release | Link an Run Configuration to a Release. Returns the updated Run Configuration detail. |
| TestPlanApi | unlinkRelease1 | POST /api/v1/run-configurations/{id}/unlink-release | Unlink an Run Configuration to a Release. Returns the updated Run Configuration detail. |
| TestProjectApi | create6 | POST /api/v1/test-projects/{id}/schedulers | Creates a new schedule for a Test Plan. Returns the created schedule detail. |
| TestProjectApi | createGitRepo | POST /api/v1/git/create | Creates a Git Test Project. Returns the Git Test Project detail. |
| TestProjectApi | createSample | POST /api/v1/test-projects/sample | Creates a new sample Test Project. Returns the created Test Project. |
| TestProjectApi | delete6 | DELETE /api/v1/test-projects/{id} | Deletes a Test Project. Returns the deleted Test Project. |
| TestProjectApi | delete7 | DELETE /api/v1/test-projects/{id}/schedulers/{schedulerId} | Deletes a schedule. Returns the deleted schedule detail. |
| TestProjectApi | download4 | GET /api/v1/test-projects/{id}/download | Downloads a Test Project package. Returns the latest Test Project package file. |
| TestProjectApi | get17 | GET /api/v1/test-projects/{id} | Returns a Test Project detail. |
| TestProjectApi | getScheduler | GET /api/v1/test-projects/{id}/schedulers/{schedulerId} | Returns a schedule detail. |
| TestProjectApi | getTestProjectGit | GET /api/v1/git/{testProjectGitId} | Returns a Git Test Project detail. |
| TestProjectApi | refreshTSC | POST /api/v1/test-projects/{id}/refresh-tsc | Refresh Test Suite Collection list of Git Test Project |
| TestProjectApi | run | PUT /api/v1/run-configurations/{id}/execute | Executes a Test Plan. Returns the build information. |
| TestProjectApi | update10 | PUT /api/v1/test-projects/{id} | Updates a Test Project detail. Returns the updated Test Project detail. |
| TestProjectApi | update9 | PUT /api/v1/test-projects/{id}/schedulers/{schedulerId} | Updates a schedule detail. Returns the updated schedule detail. |
| TestProjectApi | updateGitRepo | POST /api/v1/git/update | Updates a Git Test Project detail. Returns the updated Git Test Project detail. |
| TestProjectApi | updatePackage | POST /api/v1/test-projects/{id}/update-package | Update a Test Project package. Returns the updated Test Project detail. |
| TestProjectApi | upload1 | POST /api/v1/test-projects/upload | Creates a new Test Project. Returns the created Test Project. |
| TestReportApi | processMultipleS3File | POST /api/v1/katalon/test-reports/multiple | Saves and processes multiple uploaded Katalon reports. |
| TestReportApi | processS3File | POST /api/v1/katalon/test-reports | Saves and processes the uploaded Katalon reports. |
| TestReportApi | processTestOpsReports | POST /api/v1/testops-reports | Saves and processes multiple uploaded TestOps reports. |
| TestReportApi | updateResult | POST /api/v1/katalon/test-reports/update-result | |
| TestReportApi | uploadJUnitReports | POST /api/v1/junit/test-reports | Uploads and processes the JUnit reports to an Execution. |
| TestReportApi | uploadTestNGReports | POST /api/v1/testng/test-reports | Uploads and processes the TestNG reports to an execution. |
| TestSuiteApi | get9 | GET /api/v1/test-suites/{id} | Returns a Test Suite detail. |
| UserApi | assignUserTeam | POST /api/v1/users/add | Adds users to a Team. Returns the added User detail. |
| UserApi | changeAvatar | POST /api/v1/users/avatar | Change the avatar of the current User. Returns the updated User detail. |
| UserApi | changeName | POST /api/v1/users | Change name for current user. |
| UserApi | createOrUpdate2 | POST /api/v1/user-settings | Updates the User Settings detail. Returns the updated User Settings detail. |
| UserApi | downloadAvatar | GET /api/v1/users/avatar | Downloads the avatar of the current User. Returns the current avatar file. |
| UserApi | get10 | GET /api/v1/user-settings | Returns the User Settings detail. |
| UserApi | getMe | GET /api/v1/users/me | Returns the current User detail. |
| UserApi | removeUser | DELETE /api/v1/users/remove | Removes a User from a Team. Returns the removed User detail. |
| WebServiceApi | get16 | GET /api/v1/test-objects/{id} | Returns a Web Service detail. |
Documentation for Models
- AgentConfigResource
- AgentResource
- BuildInfo
- BuildLog
- CircleCIAgentResource
- CircleCIConnectionResource
- CircleCIProject
- CommentResource
- ConfigResource
- EnvironmentVariable
- ExecutionRequestResource
- ExecutionResource
- ExecutionShareReportResource
- ExecutionTestCaseResource
- ExecutionTestResultIdentifyResource
- ExecutionTestResultResource
- ExecutionTestSuiteResource
- ExternalIssueResource
- ExternalProjectResource
- ExternalReleaseResource
- FileResource
- GitRepositoryResource
- IncidentExecutionTestResultResource
- IncidentResource
- JobResource
- K8SAgentResource
- OrganizationFeatureFlagResource
- OrganizationResource
- OrganizationTrialRequestResource
- PageBaseResource
- PageExecutionResource
- PageJobResource
- PageProjectResource
- PageTeamResource
- Pageable
- PlatformResource
- ProjectConfigurationResource
- ProjectResource
- ProjectSettingResource
- ReleaseResource
- ReleaseStatisticsResource
- RunConfigurationResource
- SchedulerResource
- SearchConfigResource
- SearchRequest
- SearchRequestCondition
- SearchRequestFunction
- SearchRequestPagination
- SearchRequestSortOrder
- Sort
- TeamResource
- TestCasePlatformStatisticsResource
- TestCaseResource
- TestObjectEntityResource
- TestObjectResource
- TestProjectResource
- TestResultAssertionFailedResource
- TestResultAssertionResource
- TestRunResult
- TestSuiteCollectionEntityResource
- TestSuiteCollectionResource
- TestSuiteResource
- TimeZoneResource
- TimeZoneResourceOffset
- TimeZoneResourceOffsetRules
- TimeZoneResourceOffsetRulesDuration
- TimeZoneResourceOffsetRulesDurationUnits
- TimeZoneResourceOffsetRulesTransitionRules
- TimeZoneResourceOffsetRulesTransitions
- TriggerBuildParameter
- UploadBatchFileResource
- UploadBatchResource
- UploadFileResource
- UserOrganizationFeatureResource
- UserResource
- UserSettingResource
- UserTeamResource
Documentation for Authorization
Authentication schemes defined for the API:
basicScheme
- Type: HTTP basic authentication
Recommendation
It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.