---
title: "POST /testexecutions"
method: POST
path: "/testexecutions"
---

# POST /testexecutions

`POST /testexecutions`

The list of test set executions.

## Request body

- object
  - `sortBy` object — Contains information about the method by which to sort the instances of test executions you have carried out.
    - `attribute` 'TestSetName' | 'CreationDateTime' — Specifies whether to sort the test set executions by the date and time at which the test sets were created.
    - `order` 'Ascending' | 'Descending' — Specifies whether to sort in ascending or descending order.
  - `maxResults` integer — The maximum number of test executions to return in each page. If there are fewer results than the max page size, only the actual number of results are returned.
  - `nextToken` string — If the response from the ListTestExecutions operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.

## Response `200`

Success

- ListTestExecutionsResponse
  - `testExecutions` TestExecutionSummary[] — The list of test executions.
    - `testExecutionId` string — The unique identifier of the test execution.
    - `creationDateTime` string, date-time — The date and time at which the test execution was created.
    - `lastUpdatedDateTime` string, date-time — The date and time at which the test execution was last updated.
    - `testExecutionStatus` 'Pending' | 'Waiting' | 'InProgress' | 'Completed' | 'Failed' | 'Stopping' | 'Stopped' — The current status of the test execution.
    - `testSetId` string — The unique identifier of the test set used in the test execution.
    - `testSetName` string — The name of the test set used in the test execution.
    - `target` object — 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' — Specifies whether the API mode for the test execution is streaming or non-streaming.
    - `testExecutionModality` 'Text' | 'Audio' — Specifies whether the data used for the test execution is written or spoken.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the ListTestExecutions operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListTestExecutions operation request to get the next page of results.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — 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/versions/6997ba482d72/schema)