InfluxDB v2 Cloud Docs Submit API issue

InfluxDB v1 HTTP API for InfluxDB Cloud

License: MIT

The InfluxDB v1 compatibility API provides a programmatic interface for interactions with InfluxDB Cloud using InfluxDB v1-compatible endpoints.

The InfluxDB 1.x compatibility /write and /query endpoints work with InfluxDB 1.x client libraries and third-party integrations like Grafana and others.

This documentation is generated from the InfluxDB OpenAPI specification.

Authentication

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:

TokenAuthentication

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.

Syntax

Authorization: Token YOUR_INFLUX_TOKEN

For examples and more information, see the following:

Security Scheme TypeAPI Key
Header parameter name:Authorization

BasicAuthentication

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 TypeHTTP
HTTP Authorization Schemebasic

QuerystringAuthentication

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 TypeAPI Key
Query parameter name:u=&p=

Query

Query using the InfluxDB v1 HTTP API

query Parameters
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.

header Parameters
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 application/csv, query results include epoch timestamps instead of RFC3339 timestamps.

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

Request Body schema: text/plain

InfluxQL query to execute.

string

Responses

Response samples

Content type
No sample

Write

Write time series data into InfluxDB in a V1-compatible format

query Parameters
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.

header Parameters
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

Request Body schema: text/plain

Line protocol body

string

Responses

Response samples

Content type
application/json
{
  • "code": "internal error",
  • "message": "string",
  • "op": "string",
  • "err": "string",
  • "line": 0
}