---
title: "POST /testsets/{testSetId}/testexecutions"
method: POST
path: "/testsets/{testSetId}/testexecutions"
---

# POST /testsets/{testSetId}/testexecutions

`POST /testsets/{testSetId}/testexecutions`

The action to start test set execution.

## Path parameters

- `testSetId` string, required

## Request body

- object
  - `target` object, required — Contains information about the bot used for the test execution.
    - `botAliasTarget` object — Contains information about the bot alias used for the test execution.
      - `botId` string, required — The bot Id of the bot alias used in the test set execution.
      - `botAliasId` string, required — The bot alias Id of the bot alias used in the test set execution.
      - `localeId` string, required — The locale Id of the bot alias used in the test set execution.
  - `apiMode` 'Streaming' | 'NonStreaming', required — Indicates whether we use streaming or non-streaming APIs for the test set execution. For streaming, StartConversation Runtime API is used. Whereas, for non-streaming, RecognizeUtterance and RecognizeText Amazon Lex Runtime API are used.
  - `testExecutionModality` 'Text' | 'Audio' — Indicates whether audio or text is used.

## Response `202`

Success

- StartTestExecutionResponse
  - `testExecutionId` string — The unique identifier of the test set execution.
  - `creationDateTime` string, date-time — The creation date and time for the test set execution.
  - `testSetId` string — The test set Id for the test set execution.
  - `target` object — The target bot for the test set execution.
    - `botAliasTarget` object — Contains information about the bot alias used for the test execution.
      - `botId` string, required — The bot Id of the bot alias used in the test set execution.
      - `botAliasId` string, required — The bot alias Id of the bot alias used in the test set execution.
      - `localeId` string, required — The locale Id of the bot alias used in the test set execution.
  - `apiMode` 'Streaming' | 'NonStreaming' — Indicates whether we use streaming or non-streaming APIs for the test set execution. For streaming, StartConversation Amazon Lex Runtime API is used. Whereas for non-streaming, RecognizeUtterance and RecognizeText Amazon Lex Runtime API are used.
  - `testExecutionModality` 'Text' | 'Audio' — Indicates whether audio or text is used.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ResourceNotFoundException
- `483` — ValidationException
- `484` — ConflictException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/lexv2-models.md) · [All operations](https://skmtc.net/aws/apis/lexv2-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lexv2-models/revisions/6997ba482d72/schema)