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 https://cloud2.influxdata.com/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 https://cloud2.influxdata.com/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.