---
title: "POST /quantum-task"
method: POST
path: "/quantum-task"
---

# POST /quantum-task

`POST /quantum-task`

Creates a quantum task.

## Request body

- object
  - `action` string, required — The action associated with the task.
  - `clientToken` string, required — The client token associated with the request.
  - `deviceArn` string, required — The ARN of the device to run the task on.
  - `deviceParameters` string — The parameters for the device to run the task on.
  - `jobToken` string — The token for an Amazon Braket job that associates it with the quantum task.
  - `outputS3Bucket` string, required — The S3 bucket to store task result files in.
  - `outputS3KeyPrefix` string, required — The key prefix for the location in the S3 bucket to store task results in.
  - `shots` integer, required — The number of shots to use for the task.
  - `tags` object — Tags to be added to the quantum task you're creating.

## Response `201`

Success

- CreateQuantumTaskResponse
  - `quantumTaskArn` string, required — The ARN of the task created by the request.

## Other responses

- `480` — AccessDeniedException
- `481` — ThrottlingException
- `482` — DeviceOfflineException
- `483` — DeviceRetiredException
- `484` — InternalServiceException
- `485` — ServiceQuotaExceededException
- `486` — ValidationException

---

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