---
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 — The API KEY identifying the target system. This can be skipped in case the target organisation defines a single system.
  - `actor` string — The API KEY identifying the target actor. This can be skipped in case you prefer providing test suite and/or test case identifiers to match the target actor. In any case a single conformance statement must be matched based on the provided inputs.
  - `forceSequentialExecution` boolean — Whether the test sessions should be forced to execute sequentially.
  - `waitForCompletion` boolean — Whether the call should only return once the started test sessions have completed (or until a maximum wait time has elapsed).
  - `maximumWaitTime` number — In case the call should wait for the test sessions to complete, this is the maximum time (in milliseconds) to wait before returning.
  - `executionDelay` number — An optional delay (in milliseconds) before executing tests. This delay is applied between each test execution regardless of whether execution is sequential or parallel. Providing a negative value or zero is equivalent to no delay being applied.
  - `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.
    - `completed` boolean — If the call waited until test sessions were completed, this flag specifies whether the given test session is known to be completed. This may be false if the session did not complete within the maximum wait time, or altogether missing if the call was not set to wait for test session completion.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2026-02-18** `bca9c5b1c48d` — 1 info
  - added the new optional request property `executionDelay`
- **2025-03-12** `796d09ca6778` — 3 info
  - added the new optional request property `maximumWaitTime`
  - added the new optional request property `waitForCompletion`
  - added the optional property `createdSessions/items/completed` to the response with the `200` status
- **2024-08-26** `47017afa7060` — 1 info
  - removed the non-success response with the status `400`
- **2024-08-05** `fbbd04d3b4b7` — 2 info
  - the request property `actor` became optional
  - the request property `system` became optional

[Full 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/433b3c0ae6d4/schema)