Tricentis

Tricentis V2 Session API

Session V2 APIs

GitHub OpenAPI
Business capability
Software Quality Engineering BC-4200.50

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /sessions Create an exploratory testing session · Create a session #
Ask an LLM
“How do I start a new exploratory testing session in a project?”
“Can I set a test charter and objectives on a new session?”
Tell an agent
Create session {title} in project {project}.
Create session {title} in {project} with charter {charter}.
GET /sessions/{sessionId} Get an exploratory session · Get session by Id #
Ask an LLM
“Can I read a session together with its timeline and app info?”
“What details are stored on one exploratory session?”
Tell an agent
Get session {session}.
Get session {session} including {include}.
PUT /sessions/{sessionId} Update an exploratory session · Update session by Id #
Ask an LLM
“How do I change a session's title or summary?”
“Can I reassign a session to another tester?”
Tell an agent
Rename session {session} to {title}.
Assign session {session} to {user}.
DELETE /sessions/{sessionId} Delete an exploratory session · Delete a session by Id #
Ask an LLM
“How do I delete one exploratory session?”
“Can I remove a single session by id?”
Tell an agent destructive · confirm first
Delete session {session}.
Remove exploratory session {session} permanently.
GET /sessions/{sessionId}/status Get an exploratory session's status · Get status of session by Id #
Ask an LLM
“What state is an exploratory session in right now?”
“Is my session still in progress?”
Tell an agent
Get the status of session {session}.
Check whether session {session} is finished.
PUT /sessions/{sessionId}/status Change an exploratory session's status · Change status of session by Id #
Ask an LLM
“How do I mark an exploratory session as complete?”
“Can I change only the status of a session?”
Tell an agent
Set session {session} to status {status}.
Change the state of session {session} to {status}.
GET /coverages/sessions Find sessions linked to a qTest Manager object · Get all sessions relate to a qTest manager object #
Ask an LLM
“Which exploratory sessions cover a given requirement or test case?”
“Can I find sessions by the external object they are linked to?”
Tell an agent
Find sessions covering {type} {ext_id} from {publisher} in project {project}.
List the sessions linked to object {ext_id} of type {type} in project {project}, publisher {publisher}.
GET /sessions/{sessionId}/history Get an exploratory session's history · Get all session's histories #
Ask an LLM
“Who changed an exploratory session and when?”
“Can I see the edit history of a session?”
Tell an agent
Get the history of session {session}.
Show every recorded change to session {session}.

Documentation

📖
Documentation
https://docs.tricentis.com/qtest-saas/content/apis/overview/qtest_api_specification.htm
📖
APIReference
https://api.qasymphony.com/
📖
Documentation
https://docs.tricentis.com/qtest-saas/content/apis/data_export/use_data_export_api.htm
📖
APIReference
https://neoload-api.saas.neotys.com/explore/
📖
APIReference
https://api.ttm4j.tricentis.com/
📖
Documentation
https://docs.tricentis.com/ttm-for-jira/content/developer/api_overview.htm

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tricentis/refs/heads/main/openapi/tricentis-v2-session-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/tricentis/refs/heads/main/asyncapi/tricentis-qtest-webhooks.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/tricentis/refs/heads/main/data-model/tricentis-data-model.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/tricentis/refs/heads/main/mcp/tricentis-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tricentis:tricentis-v2-session-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tricentis-v2-session-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: qTest Explorer | Sessions V2 Session API
  version: 1.0.0
  description: These APIs are for internal reference by Tricentis development team only. They are not intended to be used publicly by any qTest or non-qTest users and so there is no support provided by Tricentis at any level. If you want to access these APIs, please send a support ticket to support@tricentis.com.
servers:
- url: https://session-js.qtestnet.com/
tags:
- name: v2-session
  description: Session V2 APIs
paths:
  /sessions:
    post:
      tags:
      - v2-session
      summary: Create a session
      description: ''
      responses:
        201:
          description: Session object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSession'
        description: Session object that needs to be created.
        required: true
      operationId: postSessions
      x-operation-id-source: derived
  /sessions/{sessionId}:
    get:
      tags:
      - v2-session
      summary: Get session by Id
      parameters:
      - name: sessionId
        in: path
        description: ID of session to return
        required: true
        schema:
          type: integer
          format: int64
      - name: include
        in: query
        description: 'Get more infos of session, chain query with comma, Ex: time-line,app-infos'
        schema:
          type: string
          items:
            type: string
          enum:
          - all
          - time-lines
          - app-infos
          - sys-infos
          default: all
      responses:
        200:
          description: session object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      operationId: getSessionsBySessionId
      x-operation-id-source: derived
    put:
      tags:
      - v2-session
      summary: Update session by Id
      parameters:
      - name: sessionId
        in: path
        description: ID of session to return
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: Ok
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      requestBody:
        content:
          application/json:
            schema:
              type: object
              $ref: '#/components/schemas/Session'
        required: true
      operationId: putSessionsBySessionId
      x-operation-id-source: derived
    delete:
      tags:
      - v2-session
      summary: Delete a session by Id
      parameters:
      - name: sessionId
        in: path
        description: ID of session to delete
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: OK
        400:
          description: Bad request
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      operationId: deleteSessionsBySessionId
      x-operation-id-source: derived
  /sessions/{sessionId}/status:
    get:
      tags:
      - v2-session
      summary: Get status of session by Id
      parameters:
      - name: sessionId
        in: path
        description: ID of session to get status
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: status of session
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      operationId: getSessionsBySessionIdStatus
      x-operation-id-source: derived
    put:
      tags:
      - v2-session
      summary: Change status of session by Id
      parameters:
      - name: sessionId
        in: path
        description: Id of session to change status
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: operation succeed
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
        500:
          description: Server error
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - status
              properties:
                status:
                  type: string
                  enum:
                  - running
                  - completed
                  - reviewed
        description: status string that want to change to
        required: true
      operationId: putSessionsBySessionIdStatus
      x-operation-id-source: derived
  /coverages/sessions:
    get:
      tags:
      - v2-session
      summary: Get all sessions relate to a qTest manager object
      description: ''
      parameters:
      - name: publisherName
        in: query
        description: publisher name
        required: true
        schema:
          type: string
      - name: extId
        in: query
        description: external object's Id
        required: true
        schema:
          type: string
      - name: type
        in: query
        description: object's type
        required: true
        schema:
          type: string
      - name: projectId
        in: query
        description: project's Id
        required: true
        schema:
          type: integer
      responses:
        200:
          description: Session object
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                  sessions:
                    type: array
                    items:
                      $ref: '#/components/schemas/Session'
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      operationId: getCoveragesSessions
      x-operation-id-source: derived
  /sessions/{sessionId}/history:
    get:
      tags:
      - v2-session
      summary: Get all session's histories
      description: ''
      parameters:
      - name: sessionId
        in: path
        description: Session's id
        required: true
        schema:
          type: integer
      responses:
        200:
          description: Session's histories
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                  item:
                    type: array
                    items:
                      $ref: '#/components/schemas/History'
                  links:
                    $ref: '#/components/schemas/Links'
        401:
          description: Unauthorized
        404:
          description: Not Found
        403:
          description: Forbidden
      security:
      - v2_auth: []
      x-swagger-router-controller: api.session
      operationId: getSessionsBySessionIdHistory
      x-operation-id-source: derived
components:
  schemas:
    Session:
      type: object
      properties:
        id:
          type: number
        system_id:
          type: string
        owner_user:
          type: string
        edit_user:
          type: string
        tester_name:
          type: string
        assigned_user:
          type: string
        title:
          type: string
        desc:
          type: string
        actual_duration:
          type: number
        planned_duration:
          type: number
        other_env_info:
          type: string
        executor:
          type: string
        overall_summary:
          type: string
        type:
          type: string
        tags:
          type: string
        test_charter:
          type: string
        test_objectives:
          type: string
        created_date:
          type: string
        modified_date:
          type: string
        client_name:
          type: string
        captured_date:
          type: string
        has_meta_data:
          type: boolean
        status:
          type: string
        sufix_pid:
          type: string
        client_id:
          type: number
        project_id:
          type: number
        settings:
          type: object
          properties:
            reset_trace_step_number:
              type: boolean
            show_timestamp:
              type: boolean
        doc:
          type: object
          properties:
            captured_date:
              type: string
            incl_sys_info_to_output:
              type: boolean
            version:
              type: string
        links:
          $ref: '#/components/schemas/Links'
        time_lines:
          type: array
          items:
            properties:
              id:
                type: string
              modifiled_date:
                type: string
              total_time:
                type: number
              order:
                type: number
              time_type:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  color:
                    type: string
                  catagory_name:
                    type: string
        app_infos:
          $ref: '#/components/schemas/AppInfos'
        sys_info:
          $ref: '#/components/schemas/SysInfo'
    SysInfo:
      type: object
      properties:
        id:
          type: string
        ado:
          type: string
        incl_ado:
          type: boolean
        app_version:
          type: string
        incl_app_version:
          type: boolean
        available_ram:
          type: string
        incl_available_ram:
          type: boolean
        cpu:
          type: string
        incl_cpu:
          type: boolean
        ie:
          type: string
        incl_ie:
          type: boolean
        os:
          type: string
        incl_os:
          type: boolean
        ram:
          type: string
        incl_ram:
          type: boolean
        resolutions:
          type: string
        incl_resolutions:
          type: boolean
        user:
          type: string
        incl_user:
          type: boolean
        computer_name:
          type: string
        incl_computer_name:
          type: boolean
        session_id:
          type: string
        links:
          $ref: '#/components/schemas/Links'
    History:
      type: object
      properties:
        type:
          type: string
        value:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              val_old:
                type: string
              val_new:
                type: string
        editby:
          type: string
        tracked_date:
          type: string
          description: 'tracked date ex: 2018-07-26T09:19:13.829Z'
    CreateSession:
      type: object
      required:
      - title
      - project_id
      properties:
        title:
          type: string
        captured_date:
          type: string
        client_name:
          type: string
        doc:
          type: object
          properties:
            captured_date:
              type: string
            incl_sys_info_to_output:
              type: boolean
            version:
              type: string
        settings:
          type: object
          properties:
            reset_trace_step_numbers:
              type: boolean
            show_timestamp:
              type: boolean
        sys_info:
          $ref: '#/components/schemas/SysInfo'
        app_infos:
          $ref: '#/components/schemas/AppInfos'
        edit_user:
          type: string
        has_meta_data:
          type: boolean
        owner_user:
          type: string
        planned_duration:
          type: string
        project_id:
          type: number
        status:
          type: string
        tester_name:
          type: string
        client_id:
          type: number
        desc:
          type: string
        assigned_user:
          type: string
        other_env_info:
          type: string
        overall_summary:
          type: string
        tags:
          type: string
        test_charter:
          type: string
        test_objectives:
          type: string
    AppInfo:
      type: object
      required:
      - name
      - first_action_time
      properties:
        id:
          type: string
        name:
          type: string
        file_size:
          type: string
        file_version:
          type: string
        path:
          type: string
        version:
          type: string
        first_action_time:
          type: string
        file_last_modified:
          type: string
        created_date:
          type: string
        modified_date:
          type: string
        incl_file_last_modified:
          type: boolean
        incl_file_size:
          type: boolean
        incl_file_version:
          type: boolean
        incl_path:
          type: boolean
        incl_version:
          type: boolean
        session_id:
          type: string
        links:
          $ref: '#/components/schemas/Links'
    AppInfos:
      type: array
      items:
        $ref: '#/components/schemas/AppInfo'
    Links:
      type: array
      items:
        $ref: '#/components/schemas/Link'
    Link:
      type: object
      properties:
        rel:
          type: string
        href:
          type: string
  securitySchemes:
    v2_auth:
      type: apiKey
      name: Authorization
      in: header
    v3_auth:
      type: apiKey
      name: Authorization
      in: header