---
title: "Describe a SQL query"
method: POST
path: "/sql/{owner}/{id}/describe"
tags: ["queries"]
---

# Describe a SQL query

`POST /sql/{owner}/{id}/describe`

This endpoint describes what columns will be included if the given SQL query is performed against the specified dataset.
New to SQL? Check out data.world's [SQL manual](https://docs.data.world/tutorials/dwsql/) .

## Path parameters

- `owner` string, required
- `id` string, required

## Query parameters

- `dialect` 'DW_SQL' | 'POSTGRESQL'

## Request body

- SqlQueryRequest
  - `datasetVersions` string
  - `includeTableSchema` boolean
  - `query` string, required
  - `queryRunToken` string

## Response `200`

default response

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) · [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/data/data-world-public-api/revisions/0a0cb1f94dad/schema)