---
title: Server information
description: Retrieve server metrics, health status, and version information for InfluxDB 3 Enterprise.
url: https://docs.influxdata.com/influxdb3/enterprise/api/server-information/
estimated_tokens: 2021
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/api/server-information/
---

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

Retrieve server metrics, health status, and version information for InfluxDB 3 Enterprise.

GET`/api/v3/configure/query_concurrency_limit`

### Get the query concurrency limit

Returns the current runtime limit on the maximum number of queries that can run concurrently. When the limit is set to the maximum allowed value, `maxConcurrentQueries` is omitted from the response.

This endpoint is only available in InfluxDB 3 Enterprise.

Example request[Ask AI about this](#)

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

#### Responses

200Success. Returns the current query concurrency limit.

`max_concurrent_queries`integer

The maximum number of queries that can run concurrently. Omitted when the limit is set to the maximum allowed value.

Example request body

```json
{
  "max_concurrent_queries": 32
}
```

401Unauthorized access.

`data`object

`error`string

403Access denied.

`data`object

`error`string

PUT`/api/v3/configure/query_concurrency_limit`

### Set the query concurrency limit

Sets the runtime limit on the maximum number of queries that can run concurrently. Omit `max_concurrent_queries` (or set it to `null`) to restore the limit configured at server startup.

Values below 16 are rejected unless `force=true` is set in the query string. A value of `0` is invalid, and values above the maximum allowed limit are rejected.

This endpoint is only available in InfluxDB 3 Enterprise.

#### Parameters

##### Query parameters

`force`boolean

Set to `true` to allow setting `max_concurrent_queries` to a value below the minimum of 16.

#### Request bodyrequired

Content-Type:`application/json`

`max_concurrent_queries`integer

The maximum number of queries that can run concurrently. Set to `null` (or omit) to restore the limit configured at server startup. Must be a positive integer; values below 16 require `force=true`.

Example request body

```json
{
  "max_concurrent_queries": 32
}
```

Example request[Ask AI about this](#)

```sh
curl --request PUT \
  "https://localhost:8181/api/v3/configure/query_concurrency_limit" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{"max_concurrent_queries":32}'
```

#### Responses

204No content. The query concurrency limit was updated.

400

Request failed. Possible reasons:

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

`data`object

`error`string

401Unauthorized access.

`data`object

`error`string

403Access denied.

`data`object

`error`string

DELETE`/api/v3/configure/query_concurrency_limit`

### Reset the query concurrency limit

Resets the runtime query concurrency limit to the value configured at server startup.

This endpoint is only available in InfluxDB 3 Enterprise.

Example request[Ask AI about this](#)

```sh
curl --request DELETE \
  "https://localhost:8181/api/v3/configure/query_concurrency_limit" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

204No content. The query concurrency limit was reset.

401Unauthorized access.

`data`object

`error`string

403Access denied.

`data`object

`error`string

POST`/api/v3/enterprise/configure/node/stop`

### Mark a node as stopped

Marks a node as stopped in the catalog, freeing up the licensed cores it was using for other nodes.

Use this endpoint after you have already stopped the physical instance (for example, using `kill` or stopping the container). This endpoint does not shut down the running process — you must stop the instance first.

When the node is marked as stopped:

1. Licensed cores from the stopped node are freed for reuse
2. Other nodes in the cluster see the update after their catalog sync interval

This endpoint is only available in InfluxDB 3 Enterprise.

#### Related

* [influxdb3 stop node](/influxdb3/enterprise/reference/cli/influxdb3/stop/node/)

#### Request bodyrequired

Content-Type:`application/json`

`node_id`requiredstring

The ID of the node to mark as stopped.

Example request body

```json
{
  "node_id": "node-1"
}
```

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/enterprise/configure/node/stop" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{"node_id":"node-1"}'
```

#### Responses

200Success. The node has been marked as stopped.

401Unauthorized access.

`data`object

`error`string

404Node not found.

GET`/api/v1/health`

### Health check (v1)

Checks the status of the service.

Returns `OK` if the service is running. This endpoint does not return version information.
Use the [`/ping`](#operation/GetPing) endpoint to retrieve version details.

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Enterprise.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/api/v1/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Service is running. Returns `OK`.

401Unauthorized. Authentication is required.

500Service is unavailable.

GET`/health`

### Health check

Checks the status of the service.

Returns `OK` if the service is running. This endpoint does not return version information.
Use the [`/ping`](#operation/GetPing) endpoint to retrieve version details.

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Enterprise.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Service is running. Returns `OK`.

401Unauthorized. Authentication is required.

500Service is unavailable.

GET`/metrics`

### Metrics

Retrieves Prometheus-compatible server metrics.

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/metrics" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success

GET`/ping`

### Ping the server

Returns version information for the server.

**Important**: Use a GET request. HEAD requests return `404 Not Found`.

The response includes version information in both headers and the JSON body:

* **Headers**: `x-influxdb-version` and `x-influxdb-build`
* **Body**: JSON object with `version`, `revision`, and `process_id`

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Enterprise.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The response body contains server information.

`process_id`string

A unique identifier for the server process.

Example:`"b756d9e0-cecd-4f72-b6d0-19e2d4f8cbb7"`

`revision`string

The git revision hash for the build.

Example:`"83b589b883"`

`version`string

The InfluxDB version number.

Example:`"3.8.0"`

401Unauthorized. Authentication is required.

404Not Found. Returned for HEAD requests.
Use a GET request to retrieve version information.

POST`/ping`

### Ping the server

Returns version information for the server. Accepts POST in addition to GET.

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The response body contains server information.

`process_id`string

A unique identifier for the server process.

Example:`"b756d9e0-cecd-4f72-b6d0-19e2d4f8cbb7"`

`revision`string

The git revision hash for the build.

Example:`"83b589b883"`

`version`string

The InfluxDB version number.

Example:`"3.8.0"`

401Unauthorized. Authentication is required.

404Not Found. Returned for HEAD requests.
Use a GET request to retrieve version information.

#### Related

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