---
title: "Launch one or more test sessions."
method: POST
path: "/tests/start"
tags: ["Test sessions"]
---

# Launch one or more test sessions.

`POST /tests/start`

## Request body

- SessionStartRequest — Information on the test session(s) to start.
  - `system` string, required — The API KEY identifying the target system.
  - `actor` string, required — The API KEY identifying the target actor.
  - `forceSequentialExecution` boolean — Whether the test sessions should be forced to execute sequentially.
  - `testSuite` string[] — The identifier(s) of the test suites to execute.
  - `testCase` string[] — The identifier(s) of the test cases to execute.
  - `inputMapping` InputMapping[] — Inputs to provide to test sessions. These can be applied to all test sessions, or certain test sessions identified by their relevant test case or test suite identifiers.
    - `testSuite` string[] — The identifiers of the test suite for which this input is to be provided.
    - `testCase` string[] — The identifiers of the test case for which this input is to be provided.
    - `input` AnyContent, required — The data and metadata relevant to a given test session input.
      - `name` string — The name of the input through which it is referenced in test cases.
      - `embeddingMethod` 'STRING' | 'BASE64' | 'URI' — The way in which the value of the input is to be interpreted (as the actual string value, as a Base64-encoded string or as a remote URI location).
      - `value` string — The value of the input provided as a string, to be interpreted based on the embeddingMethod input. This may be missing in case of a complex type (list or map).
      - `type` 'string' | 'number' | 'boolean' | 'binary' | 'object' | 'schema' | 'map' | 'list' — The data type of this input.
      - `encoding` string
      - `item` AnyContent[] — In case this is a complex data type (list or map) this is the array of child (contained) types.

## Response `200`

Test session(s) successfully created.

- SessionStartResponse — Information on the created test sessions.
  - `createdSessions` SessionCreationInformation[], required — Information on the created test session(s).
    - `testSuite` string, required — The identifier of the test session's relevant test suite.
    - `testCase` string, required — The identifier of the test session's relevant test case.
    - `session` string, required — The identifier assigned to the test session.

## Other responses

- `400` — The received request was invalid.

## Changes

- **2022-06-27** `06f633c06bcd` — 2 breaking, 4 warning, 2 info
  - the request property `actor` became required
  - the request property `system` became required
  - removed the request property `executionDelay`
  - removed the request property `maximumWaitTime`
  - …4 more

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/tests/start/post.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/06f633c06bcd/schema)