Tricentis Test Runs API

The Test Runs API from Tricentis — 4 operation(s) for test runs.

OpenAPI Specification

tricentis-test-runs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: TTM for Jira Test Runs API
  description: Tricentis Test Management for Jira
  version: 1.0.0
  termsOfService: https://www.tricentis.com/legal-information/general-terms-of-use/
servers:
- url: https://api.ttm4j.tricentis.com
security:
- api_key: []
tags:
- name: Test Runs
paths:
  /v1/projects/{project-key}/import/execution/junit:
    post:
      tags:
      - Test Runs
      summary: Create test runs from junit xml string.
      description: '## Import test run(s) (execution result) from JUnit XML string.

        #### Body:

        The body should be the XML content of the JUnit XML file.

        #### Query parameters:

        * **version** _(optional)_: Specify the version name which the test runs will be under.

        * **cycleName** _(optional)_: cycle name to specify.

        if not provided, it will take the it from the "name" attribute of the "testsuites" XML tag in case it exists.

        if nothing provided, it will generate a name like "Junit execution (current date)".'
      parameters:
      - name: version
        in: query
        description: version.
        schema:
          type: string
      - name: cycleName
        in: query
        description: cycleName.
        schema:
          type: string
      - name: project-key
        in: path
        required: true
        schema:
          type: string
      requestBody:
        description: junitXml.
        content:
          application/xml:
            schema:
              type: object
              properties:
                testsuite:
                  type:
                  - array
                  - 'null'
                  items:
                    type: object
                    properties:
                      testcase:
                        type:
                        - array
                        - 'null'
                        items:
                          type: object
                          properties:
                            failure:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            error:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            skipped:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            systemError:
                              type:
                              - string
                              - 'null'
                            systemOut:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                            testCaseKey:
                              type:
                              - string
                              - 'null'
                            classname:
                              type:
                              - string
                              - 'null'
                            time:
                              type: number
                              format: double
                            ownedBy:
                              type:
                              - string
                              - 'null'
                            ownerEmail:
                              type:
                              - string
                              - 'null'
                          additionalProperties: false
                      name:
                        type:
                        - string
                        - 'null'
                      tests:
                        type: integer
                        format: int32
                      failure:
                        type: integer
                        format: int32
                      timestamp:
                        type: string
                        format: date-time
                      skipped:
                        type: integer
                        format: int32
                      failureevaluating:
                        type: integer
                        format: int32
                      testsuites:
                        type:
                        - array
                        - 'null'
                        items:
                          type: object
                          properties:
                            testcase:
                              type:
                              - array
                              - 'null'
                              items:
                                type: object
                                properties:
                                  failure:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  error:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  skipped:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  systemError:
                                    type:
                                    - string
                                    - 'null'
                                  systemOut:
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                  testCaseKey:
                                    type:
                                    - string
                                    - 'null'
                                  classname:
                                    type:
                                    - string
                                    - 'null'
                                  time:
                                    type: number
                                    format: double
                                  ownedBy:
                                    type:
                                    - string
                                    - 'null'
                                  ownerEmail:
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: false
                            name:
                              type:
                              - string
                              - 'null'
                            tests:
                              type: integer
                              format: int32
                            failure:
                              type: integer
                              format: int32
                            timestamp:
                              type: string
                              format: date-time
                            skipped:
                              type: integer
                              format: int32
                            failureevaluating:
                              type: integer
                              format: int32
                          additionalProperties: false
                    additionalProperties: false
                name:
                  type:
                  - string
                  - 'null'
              additionalProperties: false
            examples:
              JunitXmlExample:
                value: "<testsuites xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" name=\"TestSuiteName\">\n  <testsuite name=\"Test suite name\" tests=\"3\" failure=\"1\" timestamp=\"2026-08-02T12:59:08.8620352+00:00\" skipped=\"1\" failure-evaluating=\"0\">\n    <testcase name=\"passedTest\" testCaseKey=\"TC-1\" classname=\"class1\" time=\"10\" ownedBy=\"user1\" ownerEmail=\"user1@example.com\" />\n    <testcase name=\"failedTest\" testCaseKey=\"TC-2\" classname=\"class1\" time=\"5\" ownedBy=\"user1\" ownerEmail=\"user1@example.com\">\n      <failure message=\"failure message\" type=\"AssertionError\">failure value</failure>\n      <system-err>System error output...</system-err>\n      <system-out>System output ...</system-out>\n    </testcase>\n    <testcase name=\"skippedTest\" classname=\"class1\" time=\"8\" ownedBy=\"user1\" ownerEmail=\"user1@example.com\">\n      <skipped message=\"skipped message\" />\n      <system-out>System output ...</system-out>\n    </testcase>\n  </testsuite>\n</testsuites>"
          application/json:
            schema:
              type: object
              properties:
                testsuite:
                  type:
                  - array
                  - 'null'
                  items:
                    type: object
                    properties:
                      testcase:
                        type:
                        - array
                        - 'null'
                        items:
                          type: object
                          properties:
                            failure:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            error:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            skipped:
                              type: object
                              properties:
                                message:
                                  type:
                                  - string
                                  - 'null'
                                type:
                                  type:
                                  - string
                                  - 'null'
                                vlue:
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: false
                            systemError:
                              type:
                              - string
                              - 'null'
                            systemOut:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                            testCaseKey:
                              type:
                              - string
                              - 'null'
                            classname:
                              type:
                              - string
                              - 'null'
                            time:
                              type: number
                              format: double
                            ownedBy:
                              type:
                              - string
                              - 'null'
                            ownerEmail:
                              type:
                              - string
                              - 'null'
                          additionalProperties: false
                      name:
                        type:
                        - string
                        - 'null'
                      tests:
                        type: integer
                        format: int32
                      failure:
                        type: integer
                        format: int32
                      timestamp:
                        type: string
                        format: date-time
                      skipped:
                        type: integer
                        format: int32
                      failureevaluating:
                        type: integer
                        format: int32
                      testsuites:
                        type:
                        - array
                        - 'null'
                        items:
                          type: object
                          properties:
                            testcase:
                              type:
                              - array
                              - 'null'
                              items:
                                type: object
                                properties:
                                  failure:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  error:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  skipped:
                                    type: object
                                    properties:
                                      message:
                                        type:
                                        - string
                                        - 'null'
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                      vlue:
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: false
                                  systemError:
                                    type:
                                    - string
                                    - 'null'
                                  systemOut:
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                  testCaseKey:
                                    type:
                                    - string
                                    - 'null'
                                  classname:
                                    type:
                                    - string
                                    - 'null'
                                  time:
                                    type: number
                                    format: double
                                  ownedBy:
                                    type:
                                    - string
                                    - 'null'
                                  ownerEmail:
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: false
                            name:
                              type:
                              - string
                              - 'null'
                            tests:
                              type: integer
                              format: int32
                            failure:
                              type: integer
                              format: int32
                            timestamp:
                              type: string
                              format: date-time
                            skipped:
                              type: integer
                              format: int32
                            failureevaluating:
                              type: integer
                              format: int32
                          additionalProperties: false
                    additionalProperties: false
                name:
                  type:
                  - string
                  - 'null'
              additionalProperties: false
            examples:
              JunitXmlExample:
                value:
                  testsuite:
                  - testcase:
                    - name: passedTest
                      testCaseKey: TC-1
                      classname: class1
                      time: 10
                      ownedBy: user1
                      ownerEmail: user1@example.com
                    - failure:
                        message: failure message
                        type: AssertionError
                        vlue: failure value
                      systemError: System error output...
                      systemOut: System output ...
                      name: failedTest
                      testCaseKey: TC-2
                      classname: class1
                      time: 5
                      ownedBy: user1
                      ownerEmail: user1@example.com
                    - skipped:
                        message: skipped message
                      systemOut: System output ...
                      name: skippedTest
                      classname: class1
                      time: 8
                      ownedBy: user1
                      ownerEmail: user1@example.com
                    name: Test suite name
                    tests: 3
                    failure: 1
                    timestamp: '2026-08-02T12:59:08.8622015Z'
                    skipped: 1
                    failureevaluating: 0
                  name: TestSuiteName
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  required:
                  - status
                  - testCaseKey
                  - testType
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    key:
                      type:
                      - string
                      - 'null'
                    created:
                      type:
                      - string
                      - 'null'
                      format: date-time
                    updated:
                      type:
                      - string
                      - 'null'
                      format: date-time
                    createdBy:
                      type:
                      - string
                      - 'null'
                    updatedBy:
                      type:
                      - string
                      - 'null'
                    cycle:
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          format: uuid
                        name:
                          type:
                          - string
                          - 'null'
                        parentId:
                          type:
                          - string
                          - 'null'
                          format: uuid
                        plannedStartDate:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        plannedEndDate:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        assignee:
                          type:
                          - string
                          - 'null'
                        version:
                          type: object
                          properties:
                            id:
                              type:
                              - string
                              - 'null'
                              format: uuid
                            jiraId:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                          additionalProperties: false
                        fields:
                          type:
                          - array
                          - 'null'
                          items:
                            type: object
                            properties:
                              schemeId:
                                type: string
                                format: uuid
                              schemeType:
                                enum:
                                - List
                                - String
                                type: string
                              schemeName:
                                type:
                                - string
                                - 'null'
                              alloweValueId:
                                type:
                                - string
                                - 'null'
                                format: uuid
                              allowedValueName:
                                type:
                                - string
                                - 'null'
                              value:
                                type:
                                - string
                                - 'null'
                            additionalProperties: false
                      additionalProperties: false
                    steps:
                      type:
                      - array
                      - 'null'
                      items:
                        type: object
                        properties:
                          index:
                            type:
                            - integer
                            - 'null'
                            format: int32
                          status:
                            type:
                            - string
                            - 'null'
                          actualResult:
                            type:
                            - string
                            - 'null'
                          data:
                            type:
                            - string
                            - 'null'
                          comment:
                            type:
                            - string
                            - 'null'
                          description:
                            type:
                            - string
                            - 'null'
                          expectedResult:
                            type:
                            - string
                            - 'null'
                          defects:
                            type:
                            - array
                            - 'null'
                            items:
                              type: string
                          defectsKeys:
                            type:
                            - array
                            - 'null'
                            items:
                              type: string
                        additionalProperties: false
                    testCaseKey:
                      minLength: 1
                      type: string
                    precondition:
                      type:
                      - string
                      - 'null'
                    status:
                      minLength: 1
                      type: string
                    name:
                      type:
                      - string
                      - 'null'
                    description:
                      type:
                      - string
                      - 'null'
                    priority:
                      type:
                      - string
                      - 'null'
                    testCategory:
                      type:
                      - string
                      - 'null'
                    testType:
                      enum:
                      - Manual
                      - Automated
                      type: string
                    assignee:
                      type:
                      - string
                      - 'null'
                    executedBy:
                      type:
                      - string
                      - 'null'
                    plannedStartDate:
                      type:
                      - string
                      - 'null'
                      format: date-time
                    plannedEndDate:
                      type:
                      - string
                      - 'null'
                      format: date-time
                    automation:
                      type: object
                      properties:
                        name:
                          type:
                          - string
                          - 'null'
                        id:
                          type:
                          - string
                          - 'null'
                        content:
                          type:
                          - string
                          - 'null'
                        result:
                          type:
                          - string
                          - 'null'
                      additionalProperties: false
                    components:
                      type:
                      - array
                      - 'null'
                      items:
                        type: string
                    componentsNames:
                      type:
                      - array
                      - 'null'
                      items:
                        type: string
                    labels:
                      type:
                      - array
                      - 'null'
                      items:
                        type: string
                    cycleName:
                      type:
                      - string
                      - 'null'
                    folderPath:
                      type:
                      - string
                      - 'null'
                    fields:
                      type:
                      - array
                      - 'null'
               

# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tricentis/refs/heads/main/openapi/tricentis-test-runs-api-openapi.yml