The InfluxDB HTTP API for InfluxDB 3 Enterprise provides a programmatic interface for interacting with InfluxDB 3 Enterprise databases and resources. Use this API to:
The API includes endpoints under the following paths:
/api/v3: InfluxDB 3 Enterprise native endpoints/: Compatibility endpoints for InfluxDB v1 workloads and clients/api/v2/write: Compatibility endpoint for InfluxDB v2 workloads and clientsCreate an admin token for the InfluxDB 3 Enterprise API.
curl -X POST "http://localhost:8181/api/v3/configure/token/admin"Check the status of the InfluxDB server.
curl "http://localhost:8181/health" \
--header "Authorization: Bearer ADMIN_TOKEN"Write data to InfluxDB.
curl "http://localhost:8181/api/v3/write_lp?db=sensors&precision=auto"
--header "Authorization: Bearer ADMIN_TOKEN" \
--data-raw "home,room=Kitchen temp=72.0
home,room=Living\ room temp=71.5"If all data is written, the response is 204 No Content.
Query data from InfluxDB.
curl -G "http://localhost:8181/api/v3/query_sql" \
--header "Authorization: Bearer ADMIN_TOKEN" \
--data-urlencode "db=sensors" \
--data-urlencode "q=SELECT * FROM home WHERE room='Living room'" \
--data-urlencode "format=jsonl"Output:
{"room":"Living room","temp":71.5,"time":"2025-02-25T20:19:34.984098"}For more information about using InfluxDB 3 Enterprise, see the Get started guide.
Authenticate to the InfluxDB 3 API using a bearer token.
The InfluxDB 3 API uses tokens for authentication.
To authenticate, include the Authorization header in your request with the value Bearer <token>.
The token must be a valid InfluxDB 3 admin token or a resource token with the required permissions for the requested operation.
Manage the in-memory cache.
The Distinct Value Cache (DVC) lets you cache distinct values of one or more columns in a table, improving the performance of queries that return distinct tag and field values.
The DVC is an in-memory cache that stores distinct values for specific columns in a table. When you create an DVC, you can specify what columns' distinct values to cache, the maximum number of distinct value combinations to cache, and the maximum age of cached values. A DVC is associated with a table, which can have multiple DVCs.
The Last Value Cache (LVC) lets you cache the most recent values for specific fields in a table, improving the performance of queries that return the most recent value of a field for specific series or the last N values of a field.
The LVC is an in-memory cache that stores the last N number of values for specific fields of series in a table. When you create an LVC, you can specify what fields to cache, what tags to use to identify each series, and the number of values to cache for each unique series. An LVC is associated with a table, which can have multiple LVCs.
Creates a distinct cache for a table.
| columns required | Array of strings |
| db required | string |
| max_age | integer Optional maximum age in seconds. |
| max_cardinality | integer Optional maximum cardinality. |
| name | string Optional cache name. |
| table required | string |
{- "db": "mydb",
- "table": "mytable",
- "columns": [
- "tag1",
- "tag2"
], - "max_cardinality": 1000,
- "max_age": 3600
}Creates a last cache for a table.
| count | integer Optional count. |
| db required | string |
| key_columns | Array of strings Optional list of key columns. |
| name | string Optional cache name. |
| table required | string |
| ttl | integer Optional time-to-live in seconds. |
| value_columns | Array of strings Optional list of value columns. |
{- "db": "mydb",
- "table": "mytable",
- "key_columns": [
- "tag1"
], - "value_columns": [
- "field1"
], - "count": 100,
- "ttl": 3600
}{- "error": "string",
- "data": { }
}InfluxDB 3 provides compatibility endpoints for InfluxDB 1.x and InfluxDB 2.x workloads and clients.
/api/v2/write endpoint
for InfluxDB v2 clients and when you bring existing InfluxDB v2 write workloads to InfluxDB 3./write endpoint for InfluxDB v1 clients and when you bring existing InfluxDB v1 write workloads to InfluxDB 3.For new workloads, use the /api/v3/write_lp endpoint.
All endpoints accept the same line protocol format.
Use the HTTP /query endpoint for InfluxDB v1 clients and v1 query workloads using InfluxQL.
For new workloads, use one of the following:
/api/v3/query_sql endpoint for new query workloads using SQL./api/v3/query_influxql endpoint for new query workloads using InfluxQL.Server information endpoints such as /health and metrics are compatible with InfluxDB 1.x and InfluxDB 2.x clients.
Writes line protocol to the specified database.
This endpoint provides backward compatibility for InfluxDB 1.x write workloads using tools such as InfluxDB 1.x client libraries, the Telegraf outputs.influxdb output plugin, or third-party tools.
Use this endpoint to send data in line protocol format to InfluxDB. Use query parameters to specify options for writing data.
| db required | string The name of the database. The name of the database. InfluxDB creates the database if it doesn't already exist, and then writes all points in the batch to the database. |
| precision required | string (PrecisionWriteCompatibility) Enum: "ms" "s" "us" "ns" The precision for unix timestamps in the line protocol batch. |
| Accept | string Default: application/json Value: "application/json" The content type that the client can understand. Writes only return a response body if they fail (partially or completely)--for example, due to a syntax problem or type mismatch. |
| Content-Encoding | string (ContentEncoding) Default: identity Enum: "gzip" "identity" The compression applied to the line protocol in the request payload.
To send a gzip payload, pass |
| Content-Length | integer (ContentLength) The size of the entity-body, in bytes, sent to InfluxDB. |
| Content-Type | string (LineProtocol) Default: text/plain; charset=utf-8 Enum: "text/plain" "text/plain; charset=utf-8" The content type of the request payload. |
measurement,tag=value field=1 1234567890
"{\n \"error\": \"write of line protocol failed\",\n \"data\": [\n {\n \"original_line\": \"dquote> home,room=Kitchen temp=hi\",\n \"line_number\": 2,\n \"error_message\": \"No fields were provided\"\n }\n ]\n}\n"Writes line protocol to the specified database.
This endpoint provides backward compatibility for InfluxDB 2.x write workloads using tools such as InfluxDB 2.x client libraries, the Telegraf outputs.influxdb_v2 output plugin, or third-party tools.
Use this endpoint to send data in line protocol format to InfluxDB. Use query parameters to specify options for writing data.
| accept_partial | boolean (AcceptPartial) Default: true Accept partial writes. |
| db required | string A database name. InfluxDB creates the database if it doesn't already exist, and then writes all points in the batch to the database. |
| precision required | string (PrecisionWriteCompatibility) Enum: "ms" "s" "us" "ns" The precision for unix timestamps in the line protocol batch. |
| Accept | string Default: application/json Value: "application/json" The content type that the client can understand. Writes only return a response body if they fail (partially or completely)--for example, due to a syntax problem or type mismatch. |
| Content-Encoding | string Default: identity Enum: "gzip" "identity" The compression applied to the line protocol in the request payload.
To send a gzip payload, pass |
| Content-Length | integer The size of the entity-body, in bytes, sent to InfluxDB. |
| Content-Type | string (LineProtocol) Default: text/plain; charset=utf-8 Enum: "text/plain" "text/plain; charset=utf-8" The content type of the request payload. |
measurement,tag=value field=1 1234567890
{- "error": "string",
- "data": { }
}Executes an InfluxQL query to retrieve data from the specified database.
This endpoint is compatible with InfluxDB 1.x client libraries and third-party integrations such as Grafana. Use query parameters to specify the database and the InfluxQL query.
| chunk_size | integer Default: 10000 The number of records that will go into a chunk.
This parameter is only used if |
| chunked | boolean Default: false If true, the response is divided into chunks of size |
| db | string <InfluxQL> The database to query. If not provided, the InfluxQL query string must specify the database. |
| epoch | string (EpochCompatibility) Enum: "ns" "u" "µ" "ms" "s" "m" "h" Formats timestamps as unix (epoch) timestamps with the specified precision instead of RFC3339 timestamps with nanosecond precision. |
| pretty | boolean Default: false If true, the JSON response is formatted in a human-readable format. |
| q required | string The InfluxQL query string. |
| Accept | string Default: application/json Enum: "application/json" "application/csv" "text/csv" The content type that the client can understand. If Returns an error if the format is invalid or non-UTF8. |
{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an InfluxQL query to retrieve data from the specified database.
| Accept | string Default: application/json Enum: "application/json" "application/csv" "text/csv" The content type that the client can understand. If Returns an error if the format is invalid or non-UTF8. |
| chunk_size | integer Default: 10000 The number of records that will go into a chunk.
This parameter is only used if |
| chunked | boolean If true, the response is divided into chunks of size |
| db | string The database to query. If not provided, the InfluxQL query string must specify the database. |
| epoch | string Enum: "ns" "u" "µ" "ms" "s" "m" "h" A unix timestamp precision.
Formats timestamps as unix (epoch) timestamps with the specified precision instead of RFC3339 timestamps with nanosecond precision. |
| pretty | boolean If true, the JSON response is formatted in a human-readable format. |
| q required | string The InfluxQL query string. |
{- "db": "string",
- "q": "string",
- "chunked": true,
- "chunk_size": 10000,
- "epoch": "ns",
- "pretty": true
}{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Manage Processing engine triggers, test plugins, and send requests to trigger On Request plugins.
InfluxDB 3 Enterprise provides the InfluxDB 3 Processing engine, an embedded Python VM that can dynamically load and trigger Python plugins in response to events in your database. Use Processing engine plugins and triggers to run code and perform tasks for different database events.
To get started with the Processing engine, see the Processing engine and Python plugins guide.
Creates a new processing engine trigger.
| db required | string |
| disabled | boolean |
| plugin_filename required | string |
object | |
| trigger_name required | string |
| trigger_specification required | string |
{- "db": "string",
- "plugin_filename": "string",
- "trigger_name": "string",
- "trigger_specification": "string",
- "trigger_arguments": { },
- "disabled": true
}{- "error": "string",
- "data": { }
}Disables a processing engine trigger.
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| db required | string |
| disabled | boolean |
| plugin_filename required | string |
object | |
| trigger_name required | string |
| trigger_specification required | string |
{- "db": "string",
- "plugin_filename": "string",
- "trigger_name": "string",
- "trigger_specification": "string",
- "trigger_arguments": { },
- "disabled": true
}{- "error": "string",
- "data": { }
}Enables a processing engine trigger.
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| db required | string |
| disabled | boolean |
| plugin_filename required | string |
object | |
| trigger_name required | string |
| trigger_specification required | string |
{- "db": "string",
- "plugin_filename": "string",
- "trigger_name": "string",
- "trigger_specification": "string",
- "trigger_arguments": { },
- "disabled": true
}{- "error": "string",
- "data": { }
}Installs packages for the plugin environment.
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| property name* | any |
{ }{- "error": "string",
- "data": { }
}Installs requirements for the plugin environment.
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| property name* | any |
{ }{- "error": "string",
- "data": { }
}{- "error": "string",
- "data": { }
}Sends a request to invoke an On Request processing engine plugin. The request can include request headers, query string parameters, and a request body, which InfluxDB passes to the plugin.
An On Request plugin implements the following signature:
def process_request(influxdb3_local, query_parameters, request_headers, request_body, args=None)The response depends on the plugin implementation.
| plugin_path required | string The path configured in the For example, if you define a trigger with the following: then, the HTTP API exposes the following plugin endpoint: |
{- "error": "string",
- "data": { }
}Sends a request to invoke an On Request processing engine plugin. The request can include request headers, query string parameters, and a request body, which InfluxDB passes to the plugin.
An On Request plugin implements the following signature:
def process_request(influxdb3_local, query_parameters, request_headers, request_body, args=None)The response depends on the plugin implementation.
| plugin_path required | string The path configured in the For example, if you define a trigger with the following: then, the HTTP API exposes the following plugin endpoint: |
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| property name* | any |
{ }{- "error": "string",
- "data": { }
}{- "version": "0.1.0",
- "revision": "f3d3d3d"
}Creates a new table within a database.
| db required | string |
Array of objects | |
| table required | string |
| tags required | Array of strings |
{- "db": "string",
- "table": "string",
- "tags": [
- "string"
], - "fields": [
- {
- "name": "string",
- "type": "utf8"
}
]
}{- "error": "string",
- "data": { }
}Creates a distinct cache for a table.
| columns required | Array of strings |
| db required | string |
| max_age | integer Optional maximum age in seconds. |
| max_cardinality | integer Optional maximum cardinality. |
| name | string Optional cache name. |
| table required | string |
{- "db": "mydb",
- "table": "mytable",
- "columns": [
- "tag1",
- "tag2"
], - "max_cardinality": 1000,
- "max_age": 3600
}Creates a last cache for a table.
| count | integer Optional count. |
| db required | string |
| key_columns | Array of strings Optional list of key columns. |
| name | string Optional cache name. |
| table required | string |
| ttl | integer Optional time-to-live in seconds. |
| value_columns | Array of strings Optional list of value columns. |
{- "db": "mydb",
- "table": "mytable",
- "key_columns": [
- "tag1"
], - "value_columns": [
- "field1"
], - "count": 100,
- "ttl": 3600
}{- "error": "string",
- "data": { }
}Creates a resource (fine-grained permissions) token. A resource token is a token that has access to specific resources in the system.
This endpoint is only available in InfluxDB 3 Enterprise.
{- "token_name": "All system information",
- "permissions": [
- {
- "resource_type": "system",
- "resource_identifier": [
- "*"
], - "actions": [
- "read"
]
}
], - "expiry_secs": 300000
}Creates an admin token. An admin token is a special type of token that has full access to all resources in the system.
{- "id": 0,
- "name": "_admin",
- "token": "apiv3_00xx0Xx0xx00XX0x0",
- "hash": "00xx0Xx0xx00XX0x0",
- "created_at": "2025-04-18T14:02:45.331Z",
- "expiry": null
}Regenerates an admin token and revokes the previous token with the same name.
{- "id": 0,
- "name": "_admin",
- "token": "apiv3_00xx0Xx0xx00XX0x0",
- "hash": "00xx0Xx0xx00XX0x0",
- "created_at": "2025-04-18T14:02:45.331Z",
- "expiry": null
}Executes an SQL query to retrieve data from the specified database.
| db required | string The name of the database. |
| format | string |
| q required | string |
| Accept | string Default: application/json Enum: "application/json" "application/jsonl" "application/vnd.apache.parquet" "text/csv" The content type that the client can understand. |
| Content-Type | string Value: "application/json" The format of the data in the request body. |
{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an SQL query to retrieve data from the specified database.
| Accept | string Default: application/json Enum: "application/json" "application/jsonl" "application/vnd.apache.parquet" "text/csv" The content type that the client can understand. |
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| database required | string The name of the database to query.
Required if the query ( |
| format | string Enum: "json" "csv" "parquet" "jsonl" "pretty" The format of the query results. |
object Additional parameters for the query. Use this field to pass query parameters. | |
| query_str required | string The query to execute. |
{- "database": "mydb",
- "query_str": "SELECT * FROM mytable",
- "format": "json",
- "params": { }
}{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an InfluxQL query to retrieve data from the specified database.
| db | string The name of the database. If you provide a query that specifies the database, you can omit the 'db' parameter from your request. |
| format | string |
| q required | string |
| Accept | string Default: application/json Enum: "application/json" "application/jsonl" "application/vnd.apache.parquet" "text/csv" The content type that the client can understand. |
{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an InfluxQL query to retrieve data from the specified database.
| Accept | string Default: application/json Enum: "application/json" "application/jsonl" "application/vnd.apache.parquet" "text/csv" The content type that the client can understand. |
| Content-Type | string Value: "application/json" The format of the data in the request body. |
| database required | string The name of the database to query.
Required if the query ( |
| format | string Enum: "json" "csv" "parquet" "jsonl" "pretty" The format of the query results. |
object Additional parameters for the query. Use this field to pass query parameters. | |
| query_str required | string The query to execute. |
{- "database": "mydb",
- "query_str": "SELECT * FROM mytable",
- "format": "json",
- "params": { }
}{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an InfluxQL query to retrieve data from the specified database.
This endpoint is compatible with InfluxDB 1.x client libraries and third-party integrations such as Grafana. Use query parameters to specify the database and the InfluxQL query.
| chunk_size | integer Default: 10000 The number of records that will go into a chunk.
This parameter is only used if |
| chunked | boolean Default: false If true, the response is divided into chunks of size |
| db | string <InfluxQL> The database to query. If not provided, the InfluxQL query string must specify the database. |
| epoch | string (EpochCompatibility) Enum: "ns" "u" "µ" "ms" "s" "m" "h" Formats timestamps as unix (epoch) timestamps with the specified precision instead of RFC3339 timestamps with nanosecond precision. |
| pretty | boolean Default: false If true, the JSON response is formatted in a human-readable format. |
| q required | string The InfluxQL query string. |
| Accept | string Default: application/json Enum: "application/json" "application/csv" "text/csv" The content type that the client can understand. If Returns an error if the format is invalid or non-UTF8. |
{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Executes an InfluxQL query to retrieve data from the specified database.
| Accept | string Default: application/json Enum: "application/json" "application/csv" "text/csv" The content type that the client can understand. If Returns an error if the format is invalid or non-UTF8. |
| chunk_size | integer Default: 10000 The number of records that will go into a chunk.
This parameter is only used if |
| chunked | boolean If true, the response is divided into chunks of size |
| db | string The database to query. If not provided, the InfluxQL query string must specify the database. |
| epoch | string Enum: "ns" "u" "µ" "ms" "s" "m" "h" A unix timestamp precision.
Formats timestamps as unix (epoch) timestamps with the specified precision instead of RFC3339 timestamps with nanosecond precision. |
| pretty | boolean If true, the JSON response is formatted in a human-readable format. |
| q required | string The InfluxQL query string. |
{- "db": "string",
- "q": "string",
- "chunked": true,
- "chunk_size": 10000,
- "epoch": "ns",
- "pretty": true
}{- "results": [
- {
- "series": [
- {
- "name": "mytable",
- "columns": [
- "time",
- "value"
], - "values": [
- [
- "2024-02-02T12:00:00Z",
- 42
]
]
}
]
}
]
}Writes line protocol to the specified database.
This endpoint provides backward compatibility for InfluxDB 1.x write workloads using tools such as InfluxDB 1.x client libraries, the Telegraf outputs.influxdb output plugin, or third-party tools.
Use this endpoint to send data in line protocol format to InfluxDB. Use query parameters to specify options for writing data.
| db required | string The name of the database. The name of the database. InfluxDB creates the database if it doesn't already exist, and then writes all points in the batch to the database. |
| precision required | string (PrecisionWriteCompatibility) Enum: "ms" "s" "us" "ns" The precision for unix timestamps in the line protocol batch. |
| Accept | string Default: application/json Value: "application/json" The content type that the client can understand. Writes only return a response body if they fail (partially or completely)--for example, due to a syntax problem or type mismatch. |
| Content-Encoding | string (ContentEncoding) Default: identity Enum: "gzip" "identity" The compression applied to the line protocol in the request payload.
To send a gzip payload, pass |
| Content-Length | integer (ContentLength) The size of the entity-body, in bytes, sent to InfluxDB. |
| Content-Type | string (LineProtocol) Default: text/plain; charset=utf-8 Enum: "text/plain" "text/plain; charset=utf-8" The content type of the request payload. |
measurement,tag=value field=1 1234567890
"{\n \"error\": \"write of line protocol failed\",\n \"data\": [\n {\n \"original_line\": \"dquote> home,room=Kitchen temp=hi\",\n \"line_number\": 2,\n \"error_message\": \"No fields were provided\"\n }\n ]\n}\n"Writes line protocol to the specified database.
This endpoint provides backward compatibility for InfluxDB 2.x write workloads using tools such as InfluxDB 2.x client libraries, the Telegraf outputs.influxdb_v2 output plugin, or third-party tools.
Use this endpoint to send data in line protocol format to InfluxDB. Use query parameters to specify options for writing data.
| accept_partial | boolean (AcceptPartial) Default: true Accept partial writes. |
| db required | string A database name. InfluxDB creates the database if it doesn't already exist, and then writes all points in the batch to the database. |
| precision required | string (PrecisionWriteCompatibility) Enum: "ms" "s" "us" "ns" The precision for unix timestamps in the line protocol batch. |
| Accept | string Default: application/json Value: "application/json" The content type that the client can understand. Writes only return a response body if they fail (partially or completely)--for example, due to a syntax problem or type mismatch. |
| Content-Encoding | string Default: identity Enum: "gzip" "identity" The compression applied to the line protocol in the request payload.
To send a gzip payload, pass |
| Content-Length | integer The size of the entity-body, in bytes, sent to InfluxDB. |
| Content-Type | string (LineProtocol) Default: text/plain; charset=utf-8 Enum: "text/plain" "text/plain; charset=utf-8" The content type of the request payload. |
measurement,tag=value field=1 1234567890
{- "error": "string",
- "data": { }
}Writes line protocol to the specified database.
Use this endpoint to send data in line protocol format to InfluxDB. Use query parameters to specify options for writing data.
| accept_partial | boolean (AcceptPartial) Default: true Accept partial writes. |
| db required | string The name of the database. The name of the database. InfluxDB creates the database if it doesn't already exist, and then writes all points in the batch to the database. |
| no_sync | boolean (NoSync) Default: false Acknowledges a successful write without waiting for WAL persistence. Related |
| precision required | string (PrecisionWrite) Enum: "auto" "millisecond" "second" "microsecond" "nanosecond" Precision of timestamps. |
| Accept | string Default: application/json Value: "application/json" The content type that the client can understand. Writes only return a response body if they fail (partially or completely)--for example, due to a syntax problem or type mismatch. |
| Content-Encoding | string (ContentEncoding) Default: identity Enum: "gzip" "identity" The compression applied to the line protocol in the request payload.
To send a gzip payload, pass |
| Content-Length | integer (ContentLength) The size of the entity-body, in bytes, sent to InfluxDB. |
| Content-Type | string (LineProtocol) Default: text/plain; charset=utf-8 Enum: "text/plain" "text/plain; charset=utf-8" The content type of the request payload. |
measurement,tag=value field=1 1234567890
{- "error": "string",
- "data": { }
}