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

# POST /testsets

`POST /testsets`

The list of the test sets

## Request body

- object
  - `sortBy` object — Contains information about the methods by which to sort the test set.
    - `attribute` 'TestSetName' | 'LastUpdatedDateTime' — Specifies whether to sort the test sets by name or by the time they were last updated.
    - `order` 'Ascending' | 'Descending' — Specifies whether to sort in ascending or descending order.
  - `maxResults` integer — The maximum number of test sets 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 ListTestSets 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

- ListTestSetsResponse
  - `testSets` TestSetSummary[] — The selected test sets in a list of test sets.
    - `testSetId` string — The unique identifier of the test set.
    - `testSetName` string — The name of the test set.
    - `description` string — The description of the test set.
    - `modality` 'Text' | 'Audio' — Specifies whether the test set contains written or spoken data.
    - `status` 'Importing' | 'PendingAnnotation' | 'Deleting' | 'ValidationError' | 'Ready' — The status of the test set.
    - `roleArn` string — The Amazon Resource Name (ARN) of an IAM role that has permission to access the test set.
    - `numTurns` integer — The number of turns in the test set.
    - `storageLocation` object — Contains information about the location at which the test set is stored.
      - `s3BucketName` string, required — The name of the Amazon S3 bucket in which the test set is stored.
      - `s3Path` string, required — The path inside the Amazon S3 bucket where the test set is stored.
      - `kmsKeyArn` string — The Amazon Resource Name (ARN) of an Amazon Web Services Key Management Service (KMS) key for encrypting the test set.
    - `creationDateTime` string, date-time — The date and time at which the test set was created.
    - `lastUpdatedDateTime` string, date-time — The date and time at which the test set was last updated.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the ListTestSets operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListTestSets 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)
