InfluxDB 1.x compatibility API
The InfluxDB v2 API includes InfluxDB 1.x compatibility endpoints that work with InfluxDB 1.x client libraries and third-party integrations like Grafana and others.
View full v1 compatibility API documentation
Authentication
InfluxDB 2.0 requires all query and write requests to be authenticated. Use basic authentication or token authentication to authenticate requests to InfluxDB 1.x compatibility endpoints.
Basic Authentication
Basic authentications requires the following credentials:
- username: InfluxDB username
- password: InfluxDB authentication token
There are multiple ways to provide basic authentication credentials.
The example below uses the Authorization
header with the Basic
scheme to
provide the required credentials:
Basic authentication with authorization header
# Header syntax
Authorization: Basic <username>:<password>
# Header example
Authorization: Basic admin:mYSuP3rs3cREtT0k3N
Token Authentication
Token authentication requires the following credential:
- token: InfluxDB authentication token
Use the Authorization
header with the Token
scheme to provide your
authentication token to InfluxDB.
Token authentication with authorization header
# Header syntax
Authorization: Token <token>
# Header example
Authorization: Token mYSuP3rs3cREtT0k3N
InfluxQL support
The compatibility API supports InfluxQL, with the following caveats:
- The
INTO
clause (e.g.SELECT ... INTO ...
) is not supported. - With the exception of
DELETE
andDROP MEASUREMENT
queries, which are still allowed, InfluxQL database management commands are not supported.
Compatibility endpoints
/query
The /query
1.x compatibility endpoint queries InfluxDB Cloud and InfluxDB OSS 2.0 using InfluxQL.
GET http://localhost:8086/query
/write
The /write
1.x compatibility endpoint writes data to InfluxDB Cloud and InfluxDB OSS 2.0 using patterns from the InfluxDB 1.x /write
API endpoint.
POST http://localhost:8086/write
Database and retention policy mapping
The database and retention policy (DBRP) mapping service maps InfluxDB 1.x database and retention policy combinations to InfluxDB Cloud and InfluxDB OSS 2.0 buckets.
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, the following resources are available:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.