---
title: Query groups
description: 'Manage distributed query groups–named sets of query nodes that InfluxDB 3 Enterprise load-balances queries across. Not yet operational: These endpoints work and store query group definitions in the catalog, but InfluxDB 3 Enterprise doesn’t yet use those definitions to affect query routing, data placement, or replication.'
url: https://docs.influxdata.com/influxdb3/enterprise/api/query-groups/
estimated_tokens: 1808
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/api/query-groups/
---

[Download InfluxDB 3 Enterprise API Spec](/openapi/influxdb3-enterprise-openapi.yml)

Manage distributed query groups–named sets of query nodes that InfluxDB 3 Enterprise load-balances queries across.

>
>
> **Not yet operational**: These endpoints work and store query group definitions in the catalog, but InfluxDB 3 Enterprise doesn’t yet use those definitions to affect query routing, data placement, or replication.
>
>

GET`/api/v3/enterprise/configure/query_groups`Not operational

### List distributed query groups (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 show query\_groups](/influxdb3/enterprise/reference/cli/influxdb3/show/query_groups/)

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. Not documented. This endpoint is not yet operational; response fields aren’t finalized.

401Unauthorized access.

`data`object

`error`string

POST`/api/v3/enterprise/configure/query_groups`Not operational

### Create a distributed query group (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 create query\_group](/influxdb3/enterprise/reference/cli/influxdb3/create/query_group/)

#### Request bodyrequired

Content-Type:`application/json`

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json"
```

#### Responses

201Created. Not documented. This endpoint is not yet operational; response fields aren’t finalized.

400

Request failed. Possible reasons:

* Invalid database name
* Malformed request body
* Invalid timestamp precision

`data`object

`error`string

401Unauthorized access.

`data`object

`error`string

GET`/api/v3/enterprise/configure/query_groups/{id}`Not operational

### Retrieve a distributed query group (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Parameters

##### Path parameters

`id`requiredinteger

The ID of the query group.

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups/{id}" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. Not documented. This endpoint is not yet operational; response fields aren’t finalized.

401Unauthorized access.

`data`object

`error`string

404Query group not found.

PUT`/api/v3/enterprise/configure/query_groups/{id}`Not operational

### Replace a distributed query group (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 update query\_group](/influxdb3/enterprise/reference/cli/influxdb3/update/query_group/)

#### Parameters

##### Path parameters

`id`requiredinteger

The ID of the query group.

#### Request bodyrequired

Content-Type:`application/json`

Example request[Ask AI about this](#)

```sh
curl --request PUT \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups/{id}" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json"
```

#### Responses

200Success. Not documented. This endpoint is not yet operational; response fields aren’t finalized.

400

Request failed. Possible reasons:

* Invalid database name
* Malformed request body
* Invalid timestamp precision

`data`object

`error`string

401Unauthorized access.

`data`object

`error`string

404Query group not found.

PATCH`/api/v3/enterprise/configure/query_groups/{id}`Not operational

### Update a distributed query group (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 update query\_group](/influxdb3/enterprise/reference/cli/influxdb3/update/query_group/)

#### Parameters

##### Path parameters

`id`requiredinteger

The ID of the query group.

#### Request bodyrequired

Content-Type:`application/json`

Example request[Ask AI about this](#)

```sh
curl --request PATCH \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups/{id}" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json"
```

#### Responses

200Success. Not documented. This endpoint is not yet operational; response fields aren’t finalized.

400

Request failed. Possible reasons:

* Invalid database name
* Malformed request body
* Invalid timestamp precision

`data`object

`error`string

401Unauthorized access.

`data`object

`error`string

404Query group not found.

DELETE`/api/v3/enterprise/configure/query_groups/{id}`Not operational

### Delete a distributed query group (not yet operational)

Reserved for the distributed query group feature.

>
>
> **Not yet operational**: Request and response fields aren’t finalized, and InfluxDB 3 Enterprise doesn’t yet use query group definitions to affect query routing, data placement, or replication.
>
>

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 delete query\_group](/influxdb3/enterprise/reference/cli/influxdb3/delete/query_group/)

#### Parameters

##### Path parameters

`id`requiredinteger

The ID of the query group.

Example request[Ask AI about this](#)

```sh
curl --request DELETE \
  "https://localhost:8181/api/v3/enterprise/configure/query_groups/{id}" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The query group has been deleted.

401Unauthorized access.

`data`object

`error`string

404Query group not found.

#### Related

* [Configure query groups](/influxdb3/enterprise/admin/query-groups/)
* [InfluxDB 3 API client libraries](/influxdb3/enterprise/reference/client-libraries/v3/)