---
title: "Delete Query"
method: DELETE
path: "/api/v1/queries/{query_id}"
tags: ["queries"]
---

# Delete Query

`DELETE /api/v1/queries/{query_id}`

## Path parameters

- `query_id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- QueriesAppApiV1SchemaGetQueryResponse
  - `query_id` string, uuid, required
  - `query` string, required
  - `type` 'NATURAL_LANGUAGE' | 'SQL', required — All possible query types
  - `status` 'Queued' | 'Running' | 'Stopping' | 'Stopped' | 'Complete' | 'Error', required — All possible query status values
  - `results` string, nullable, required
  - `start_dt` string, date-time, nullable
  - `end_dt` string, date-time, nullable
  - `dataset_id` string, uuid, required
  - `total_row_count` integer, nullable
  - `parameters` object, nullable
  - `created_dt` string, date-time, required
  - `updated_dt` string, date-time, required
  - `created_user_id` string, required
  - `updated_user_id` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `delete-query-api-v-1-queries-query-id-delete` removed and replaced with `queries_delete_query_api_v1_queries__query_id__delete`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v1/queries/:query_id/delete.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/coactive/apis/api-reference/revisions/3683abf6922b?raw)