test-suite
2023.4
false
Test Suite User Guide
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Aug 13, 2024

API version

Test Manager provides two API versions through which you can integrate. The first version of the APIs is not protected with role-based access control. The second version of the APIs is protected with role-based access control in a given project's scope. Several legacy APIs are only accessible by Organization Administrators. The second version of these APIs can now be accessed by Project Owners too, even if they are not Organization Administrators.

Version schedule

V1 has been deprecated and removed in April 2023 (2023.4 release) for both Standalone and Automation Suite version of Test Manager.

Version-based APIs

API Version

Permissions

Description

V1

• Attachments

• AzureDevOpsConnector (deprecated)

• Capabilities

• Configuration

• Connectors (deprecated)

• CustomFieldDefinitions (deprecated)

• CustomFieldValues

• Defects

• JiraCloudBasicAuthConnector (deprecated)

• JiraCloudOAuthConnector (deprecated)

• JiraConnectorWebHooks

• JireServerConnector (deprecated)

• KPIs

• ObjectLabels

• Orchestrator

• ProjectReports

• Projects (deprecated)

• RedmineConnector (deprecated)

• Requirements (deprecated)

• ServerInfo

• ServiceNowConnector (deprecated)

• Settings

• Telemetry

• TestCaseLogs

• TestCases

• TestExecutions

• TestSets

• TestSteps

• ThirdPartyAuth (deprecated)

• UserAuth

• Users

• UserSession

• UserSettings

• WebHookConfiguration (deprecated)

• XrayCloudConnector (deprecated)

• XrayConnectorWebhooks

• XrayServerConnector (deprecated)

Available for Organization Administrators and non-admin users.

Not protected through role-based access control.

V2

• AzureDevOpsConnector

• Connectors

• CustomFieldDefinitions

• JiraCloudBasicAuthConnector

• JiraCloudOAuthConnector

• JiraServerConnector

• ProjectPermissions

• Projects

• QtestConnector

• RedmineConnector

• Requirements

• ServiceNowConnector

• WebHookConfiguration

• XrayCloudConnector

• XrayServerConnector

Available for Admins and Project Owners.

Update API Version

Update the API version using Swagger to make role-based access calls.

  1. Add /swagger/index.html to your Test Manager instance URL (e.g., https://testmanager.com/swagger/index.html).
  2. Click Select a definition at the top of the page and select V2 from the dropdown list.

    Now the requests include the version number as you can see in the following example.

    curl -X 'GET' \
      'https://company/testmanager/companyTenant/testmanager_/api/v2/projects' \
      -H 'accept: application/json'curl -X 'GET' \
      'https://company/testmanager/companyTenant/testmanager_/api/v2/projects' \
      -H 'accept: application/json'


Related articles

  • Version schedule
  • Version-based APIs
  • Update API Version

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.