/write 1.x compatibility API
This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.
The /write 1.x compatibility endpoint writes data to InfluxDB Cloud and InfluxDB OSS 2.7
using patterns from the InfluxDB 1.x /write API endpoint.
Use the POST request method to write line protocol
to the /write endpoint.
Authentication
Use one of the following authentication methods:
- token authentication
- basic authentication with username and password
- query string authentication with username and password
For more information, see Authentication.
Request body
Include your line protocol in the request body.
Binary encode the line protocol to prevent unintended formatting.
The examples below use the curl --data-binary flag to binary
encode the line protocol.
Query string parameters
u
(Optional) The 1.x username to authenticate the request. See query string authentication.
p
(Optional) The 1.x password to authenticate the request. See query string authentication.
db
(Required) The database to write data to. This is mapped to an InfluxDB bucket. See Database and retention policy mapping.
rp
The retention policy to write data to. This is mapped to an InfluxDB bucket. See Database and retention policy mapping.
precision
The precision of Unix timestamps in the line protocol.
Default is nanosconds (ns).
The following precisions are available:
ns- nanosecondsuorµ- microsecondsms- millisecondss- secondsm- minutesh- hours
Write examples
- Write data using basic authentication
- Write data to a non-default retention policy
- Write multiple lines of line protocol
- Write data with millisecond Unix timestamps
- Use curl to write data from a file
Write data using basic authentication
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--user "USERNAME:PASSWORD_OR_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
Write data using token authentication
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
Write data to a non-default retention policy
curl --request POST "http://localhost:8086/write?db=DATABASE_NAME&rp=RETENTION_POLICY" \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
Write multiple lines of line protocol
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000
measurement,host=host2 field1=14i,field2=12.7 1577836800000000000
measurement,host=host3 field1=5i,field2=6.8 1577836800000000000"
Write data with millisecond Unix timestamps
curl --request POST "http://localhost:8086/write?db=DATABASE_NAME&precision=ms" \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000"
Use curl to write data from a file
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary @path/to/line-protocol.txt
Replace the following:
DATABASE_NAMEandRETENTION_POLICY: the database and retention policy mapping (DBRP) for the InfluxDB v2 bucket that you want to write toUSERNAME: your InfluxDB 1.x usernamePASSWORD_OR_TOKEN: your InfluxDB 1.x password or InfluxDB API tokenAPI_TOKEN: your InfluxDB API token
Was this page helpful?
Thank you for your feedback!
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, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.