The InfluxDB 1.x compatibility /write and /query endpoints work with InfluxDB 1.x client libraries and third-party integrations like Grafana and others.
If you want to use the latest InfluxDB /api/v2 API instead, see the InfluxDB v2 API documentation.
This documentation is generated from the InfluxDB OpenAPI specification.
The InfluxDB 1.x API requires authentication for all requests. InfluxDB Cloud uses InfluxDB API tokens to authenticate requests.
For more information, see the following:
Use the Token authentication scheme to authenticate to the InfluxDB API.
In your API requests, send an Authorization header.
For the header value, provide the word Token followed by a space and an InfluxDB API token.
The word Token is case-sensitive.
Authorization: Token YOUR_INFLUX_TOKEN
For examples and more information, see the following:
/authorizations endpoint.| Security Scheme Type | API Key |
|---|---|
| Header parameter name: | Authorization |
Use the HTTP Basic authentication
scheme with clients that support the InfluxDB 1.x convention of username and password (that don't support the Authorization: Token scheme):
For examples and more information, see how to authenticate with a username and password.
| Security Scheme Type | HTTP |
|---|---|
| HTTP Authorization Scheme | basic |
Use the Querystring authentication scheme with InfluxDB 1.x API parameters to provide credentials through the query string.
For examples and more information, see how to authenticate with a username and password.
| Security Scheme Type | API Key |
|---|---|
| Query parameter name: | u=&p= |
| db required | string Bucket to query. |
| p | string User token. |
| q | string Defines the influxql query to run. |
| rp | string Retention policy name. |
| u | string Username. |
| Accept | string Default: application/json Enum: "application/json" "application/csv" "text/csv" "application/x-msgpack" Specifies how query results should be encoded in the response. Note: With |
| Accept-Encoding | string Default: identity Enum: "gzip" "identity" The Accept-Encoding request HTTP header advertises which content encoding, usually a compression algorithm, the client is able to understand. |
| Content-Type | string Value: "application/vnd.influxql" |
| Zap-Trace-Span | string Example: trace_id,1,span_id,1,baggage,[object Object] OpenTracing span context |
InfluxQL query to execute.
| db required | string Bucket to write to. If none exists, InfluxDB creates a bucket with a default 3-day retention policy. |
| p | string User token. |
| precision | string Write precision. |
| rp | string Retention policy name. |
| u | string Username. |
| Content-Encoding | string Default: identity Enum: "gzip" "identity" When present, its value indicates to the database that compression is applied to the line protocol body. |
| Zap-Trace-Span | string Example: trace_id,1,span_id,1,baggage,[object Object] OpenTracing span context |
Line protocol body
{- "code": "internal error",
- "message": "string",
- "op": "string",
- "err": "string",
- "line": 0
}