---
title: "POST /queries/execution"
method: POST
path: "/queries/execution"
---

# POST /queries/execution

`POST /queries/execution`

Run queries to access information from your knowledge graph of entities within individual workspaces.

The ExecuteQuery action only works with [Amazon Web Services Java SDK2](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html). ExecuteQuery will not work with any Amazon Web Services Java SDK version < 2.x.

## Request body

- object
  - `workspaceId` string, required — The ID of the workspace.
  - `queryStatement` string, required — The query statement.
  - `maxResults` integer — The maximum number of results to return at one time. The default is 50.
  - `nextToken` string — The string that specifies the next page of results.

## Response `200`

Success

- ExecuteQueryResponse
  - `columnDescriptions` ColumnDescription[] — A list of ColumnDescription objects.
    - `name` string — The name of the column description.
    - `type` 'NODE' | 'EDGE' | 'VALUE' — The type of the column description.
  - `rows` Row[] — Represents a single row in the query results.
    - `rowData` QueryResultValue[] — The data in a row of query results.
  - `nextToken` string — The string that specifies the next page of results.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — QueryTimeoutException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — ServiceQuotaExceededException

---

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