---
title: "POST /suiteDefinitions/{suiteDefinitionId}/suiteRuns"
method: POST
path: "/suiteDefinitions/{suiteDefinitionId}/suiteRuns"
---

# POST /suiteDefinitions/{suiteDefinitionId}/suiteRuns

`POST /suiteDefinitions/{suiteDefinitionId}/suiteRuns`

Starts a Device Advisor test suite run.

Requires permission to access the [StartSuiteRun](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `suiteDefinitionId` string, required

## Request body

- object
  - `suiteDefinitionVersion` string — Suite definition version of the test suite.
  - `suiteRunConfiguration` object, required — Gets suite run configuration.
    - `primaryDevice` object — Sets the primary device for the test suite run. This requires a thing ARN or a certificate ARN.
      - `thingArn` string — Lists devices thing ARN.
      - `certificateArn` string — Lists devices certificate ARN.
    - `selectedTestList` UUID[] — Sets test case list.
    - `parallelRun` boolean — TRUE if multiple test suites run in parallel.
  - `tags` object — The tags to be attached to the suite run.

## Response `200`

Success

- StartSuiteRunResponse
  - `suiteRunId` string — Suite Run ID of the started suite run.
  - `suiteRunArn` string — Amazon Resource Name (ARN) of the started suite run.
  - `createdAt` string, date-time — Starts a Device Advisor test suite run based on suite create time.
  - `endpoint` string — The response of an Device Advisor test endpoint.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ConflictException

---

[API](https://skmtc.net/aws/apis/iotdeviceadvisor.md) · [All operations](https://skmtc.net/aws/apis/iotdeviceadvisor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotdeviceadvisor/versions/9a6cea03b52e/schema)