Server information

Download InfluxDB 3 Enterprise API Spec
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
curl --request GET \
  "https://localhost:8181/api/v3/configure/query_concurrency_limit" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Success. 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
{
  "max_concurrent_queries": 32
}
401 Unauthorized access.
data object
error string
403 Access 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 body required

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
{
  "max_concurrent_queries": 32
}
Example request Ask AI about this
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

204 No 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
401 Unauthorized access.
data object
error string
403 Access 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
curl --request DELETE \
  "https://localhost:8181/api/v3/configure/query_concurrency_limit" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

204 No content. The query concurrency limit was reset.
401 Unauthorized access.
data object
error string
403 Access 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.

Request body required

Content-Type: application/json
node_id required string
The ID of the node to mark as stopped.
Example request body
{
  "node_id": "node-1"
}
Example request Ask AI about this
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

200 Success. The node has been marked as stopped.
401 Unauthorized access.
data object
error string
404 Node 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 endpoint to retrieve version details.

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

Example request Ask AI about this
curl --request GET \
  "https://localhost:8181/api/v1/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Service is running. Returns OK.
401 Unauthorized. Authentication is required.
500 Service 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 endpoint to retrieve version details.

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

Example request Ask AI about this
curl --request GET \
  "https://localhost:8181/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Service is running. Returns OK.
401 Unauthorized. Authentication is required.
500 Service is unavailable.
GET /metrics

Metrics

Retrieves Prometheus-compatible server metrics.
Example request Ask AI about this
curl --request GET \
  "https://localhost:8181/metrics" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Success
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
curl --request GET \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Success. 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"
401 Unauthorized. Authentication is required.
404 Not 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
curl --request POST \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 Success. 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"
401 Unauthorized. Authentication is required.
404 Not Found. Returned for HEAD requests. Use a GET request to retrieve version information.

Was this page helpful?

Thank you for your feedback!