Public APIs

Tosca Cloud offers public APIs for specific tasks. Most of their functionality is only available to administrators.

Identity API

https://<your_tenant>.my.tricentis.com/_identity/apiDocs/swagger/index.html

Use this API to get client ID and client secret. This is required for some setup or integration tasks.

Test case editor API

https://<your_tenant>.my.tricentis.com/_mbt/apiDocs/swagger/index.html

Use this API to manage modules, test cases, and reusable test steps.

Playlist API

https://<your_tenant>.my.tricentis.com/_playlists/apiDocs/swagger/index.html

Use this API to run your playlists, get their progress and results, and integrate them with your CI/CD pipeline.

Simulations API

https://<your_tenant>.my.tricentis.com/_simulations/apiDocs/swagger/index.html

Use this API to create, read, or delete simulation files.

Inventory API

https://<your_tenant>.my.tricentis.com/_inv/apiDocs/swagger/index.html

Use this API to search and access assets in your Inventory.

Test outline API

https://<your_tenant>.my.tricentis.com/_integrations/apiDocs/swagger/index.html

If your test cases live in a system without a dedicated Tosca Cloud integration, use this API to import them. Each call creates one new test case and stores the imported steps as its test outline, an ordered set of manual steps.

After you import the test case, you can manually build a test sequence, using the imported steps as a reference or open it and use Tosca Agentic Test Automation to generate automated test steps from the outline.

Example request

To try this example, open the Swagger page above, select Try it out for CreateTestCaseWithOutlineV1, and paste the following request body. It creates a test case named Sample test case with one step group containing one step, and stores them as its test outline.

Copy

{
  "testCaseName": "Sample test case",
  "source": "MyIntegration",
  "groups": [
    {
      "order": 1,
      "description": "Sign in",
      "steps": [
        {
          "order": 1,
          "description": "Open the login page and enter valid credentials",
          "expectedResult": "User is signed in"
        }
      ]
    }
  ]
}