---
title: "PUT /testsetgenerations"
method: PUT
path: "/testsetgenerations"
---

# PUT /testsetgenerations

`PUT /testsetgenerations`

The action to start the generation of test set.

## Request body

- object
  - `testSetName` string, required — The test set name for the test set generation request.
  - `description` string — The test set description for the test set generation request.
  - `storageLocation` object, required — Contains information about the location in which the test set is stored.
    - `s3BucketName` string — The name of the Amazon S3 bucket in which the test set is stored.
    - `s3Path` string — 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.
  - `generationDataSource` object, required — Contains information about the data source from which the test set is generated.
    - `conversationLogsDataSource` object — Contains information about the bot from which the conversation logs are sourced.
      - `botId` string, required — The bot Id from the conversation logs.
      - `botAliasId` string, required — The bot alias Id from the conversation logs.
      - `localeId` string, required — The locale Id of the conversation log.
      - `filter` object, required — The filter for the data source of the conversation log.
        - `startTime` string, date-time, required — The start time for the conversation log.
        - `endTime` string, date-time, required — The end time for the conversation log.
        - `inputMode` 'Speech' | 'Text', required — The selection to filter by input mode for the conversation logs.
  - `roleArn` string, required — The roleARN used for any operation in the test set to access resources in the Amazon Web Services account.
  - `testSetTags` object — A list of tags to add to the test set. You can only add tags when you import/generate a new test set. You can't use the <code>UpdateTestSet</code> operation to update tags. To update tags, use the <code>TagResource</code> operation.

## Response `202`

Success

- StartTestSetGenerationResponse
  - `testSetGenerationId` string — The unique identifier of the test set generation to describe.
  - `creationDateTime` string, date-time — The creation date and time for the test set generation.
  - `testSetGenerationStatus` 'Generating' | 'Ready' | 'Failed' | 'Pending' — The status for the test set generation.
  - `testSetName` string — The test set name used for the test set generation.
  - `description` string — The description used for the test set generation.
  - `storageLocation` object — The Amazon S3 storage location for the test set generation.
    - `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.
  - `generationDataSource` object — The data source for the test set generation.
    - `conversationLogsDataSource` object — Contains information about the bot from which the conversation logs are sourced.
      - `botId` string, required — The bot Id from the conversation logs.
      - `botAliasId` string, required — The bot alias Id from the conversation logs.
      - `localeId` string, required — The locale Id of the conversation log.
      - `filter` object, required — The filter for the data source of the conversation log.
        - `startTime` string, date-time, required — The start time for the conversation log.
        - `endTime` string, date-time, required — The end time for the conversation log.
        - `inputMode` 'Speech' | 'Text', required — The selection to filter by input mode for the conversation logs.
  - `roleArn` string — The roleARN used for any operation in the test set to access resources in the Amazon Web Services account.
  - `testSetTags` object — A list of tags that was used for the test set that is being generated.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — ConflictException
- `484` — ResourceNotFoundException
- `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)