InfluxDB Data I/O endpoints API is one of 40 APIs that InfluxDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Data I/O endpoints. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, authentication docs, and a getting-started guide.
This API exposes
10 operations
across 9 paths,
and defines 67 schemas.
It is described by OpenAPI 3.0.0.
Requests are made against the base URL https://cloud2.influxdata.com/api/v2.
10 operations9 paths67 schemas4 GET6 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.0
Base URL
https://cloud2.influxdata.com/api/v2
Authentication
HTTP Basic, API Key
Resource Areas
1
Authentication & Security 2
InfluxDB Data I/O endpoints API declares
2 security schemes
for authenticating requests.
It accepts HTTP basic authentication (BasicAuthentication).
An API key is passed in the header as Authorization (TokenAuthentication).
By default, every request must be authenticated.
BasicAuthentication — Basic authentication scheme Use the HTTP Basic authentication scheme for InfluxDB /api/v2 API operations that support it: Syntax Authorization: Basic BASE64ENC…
TokenAuthentication — Use the [Token authentication](section/Authentication/TokenAuthentication) scheme to authenticate to the InfluxDB API. In your API requests, send an Authorizat…
Paths & Operations 10
Across 9 paths, the API surfaces 10 operations — 4 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.
The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are Task (21 properties), TaskCreateRequest (11 properties), Run (10 properties), Script (9 properties). Each schema is shown below with its type and property counts.
Task
object
21 properties3 required
File
object
Represents a source from a single file
5 properties
Link
string
URI of resource.
PackageClause
object
Defines a package identifier
2 properties
ErrorCode
string
code is the machine-readable error code.
TaskCreateRequest
object
11 properties
ArrayExpression
object
Used to create and directly specify the elements of an array object
2 properties
FunctionExpression
object
Function expression
3 properties
LogicalExpression
object
Represents the rule conditions that collectively evaluate to either true or false
4 properties
OptionStatement
object
A single variable declaration
2 properties
ScriptInvocationParams
object
1 property
DictExpression
object
Used to create and directly specify the elements of a dictionary
2 properties
DurationLiteral
object
Represents the elapsed time between two instants as an int64 nanosecond count with syntax of golang's time.Duration
2 properties
ScriptHTTPResponseData
string
The response body contains the results of the executed script. The response is user-defined and dynamic.
PipeExpression
object
Call expression with pipe argument
3 properties
DeletePredicateRequest
object
The delete predicate request.
3 properties2 required
PropertyKey
PipeLiteral
object
Represents a specialized literal value, indicating the left hand value of a pipe expression
1 property
ParenExpression
object
Represents an expression wrapped in parenthesis
2 properties
Property
object
The value associated with a key
3 properties
CallExpression
object
Represents a function call
3 properties
ScriptLanguage
string
Duration
object
A pair consisting of length of time and the unit of time measured. It is the atomic unit from which all duration literals are composed.
3 properties
WritePrecision
string
StringLiteral
object
Expressions begin and end with double quote marks
2 properties
Label
object
4 properties
Query
object
Query InfluxDB with the Flux language
6 properties1 required
NodeType
string
Type of AST node
Run
object
10 properties
Labels
array
MemberExpression
object
Represents accessing a property of an object
3 properties
Error
object
4 properties1 required
FloatLiteral
object
Represents floating point numbers according to the double representations defined by the IEEE-754-1985
2 properties
UnsignedIntegerLiteral
object
Represents integer numbers
2 properties
BinaryExpression
object
uses binary operators to act on two operands in an expression
4 properties
ExpressionStatement
object
May consist of an expression that doesn't return a value and is executed solely for its side-effects
2 properties
Statement
MemberAssignment
object
Object property assignment
3 properties
LogEvent
object
3 properties
LineProtocolError
object
5 properties1 required
RunManually
object
1 property
Script
object
9 properties3 required
BooleanLiteral
object
Represents boolean values
2 properties
Block
object
A set of statements
2 properties
BuiltinStatement
object
Declares a builtin identifier and its type
2 properties
BadStatement
object
A placeholder for statements for which no correct statement nodes can be created
2 properties
Scripts
object
1 property
ObjectExpression
object
Allows the declaration of an anonymous object within a declaration
2 properties
IndexExpression
object
Represents indexing into an array
3 properties
ConditionalExpression
object
Selects one of two expressions, Alternate or Consequent, depending on a third boolean expression, Test
4 properties
Identifier
object
A valid Flux identifier
2 properties
ImportDeclaration
object
Declares a package import
3 properties
TestStatement
object
Declares a Flux test case
2 properties
RegexpLiteral
object
Expressions begin and end with / and are regular expressions with syntax accepted by RE2
2 properties
Links
object
URI pointers for additional paged results.
3 properties1 required
TaskStatusType
string
inactive cancels scheduled runs and prevents manual runs of the task.
VariableAssignment
object
Represents the declaration of a variable
3 properties
Tasks
object
2 properties
Dialect
object
Options for tabular data output. Default output is [annotated CSV](https://docs.influxdata.com/influxdb/cloud/reference/syntax/annotated-csv/csv-response-forma…
5 properties
UnaryExpression
object
Uses operators to act on a single operand in an expression
3 properties
DateTimeLiteral
object
Represents an instant in time with nanosecond precision in [RFC3339Nano date/time format](https://docs.influxdata.com/influxdb/cloud/reference/glossary/rfc3339…
2 properties
Expression
DictItem
object
A key-value pair in a dictionary.
3 properties
Node
ReturnStatement
object
Defines an expression to return
2 properties
LineProtocolLengthError
object
2 properties2 required
IntegerLiteral
object
Represents integer numbers
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
