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

# POST /quantum-tasks

`POST /quantum-tasks`

Searches for tasks that match the specified filter values.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `filters` SearchQuantumTasksFilter[], required — Array of <code>SearchQuantumTasksFilter</code> objects.
    - `name` string, required — The name of the device used for the task.
    - `operator` 'LT' | 'LTE' | 'EQUAL' | 'GT' | 'GTE' | 'BETWEEN', required — An operator to use in the filter.
    - `values` String256[], required — The values to use for the filter.
  - `maxResults` integer — Maximum number of results to return in the response.
  - `nextToken` string — A token used for pagination of results returned in the response. Use the token returned from the previous request continue results where the previous request ended.

## Response `200`

Success

- SearchQuantumTasksResponse
  - `nextToken` string — A token used for pagination of results, or null if there are no additional results. Use the token value in a subsequent request to continue results where the previous request ended.
  - `quantumTasks` QuantumTaskSummary[], required — An array of <code>QuantumTaskSummary</code> objects for tasks that match the specified filters.
    - `createdAt` string, date-time, required — The time at which the task was created.
    - `deviceArn` string, required — The ARN of the device the task ran on.
    - `endedAt` string, date-time — The time at which the task finished.
    - `outputS3Bucket` string, required — The S3 bucket where the task result file is stored..
    - `outputS3Directory` string, required — The folder in the S3 bucket where the task result file is stored.
    - `quantumTaskArn` string, required — The ARN of the task.
    - `shots` integer, required — The shots used for the task.
    - `status` 'CREATED' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLING' | 'CANCELLED', required — The status of the task.
    - `tags` object — Displays the key, value pairs of tags associated with this quantum task.

## Other responses

- `480` — AccessDeniedException
- `481` — ThrottlingException
- `482` — InternalServiceException
- `483` — 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)