Write

Download InfluxDB API Spec
Write time series data to InfluxDB v1 in line protocol format using the /write endpoint.
POST /write

Write data

Write time series data to InfluxDB using line protocol format.

Data must be sent as binary encoded line protocol in the request body. Use the --data-binary flag with curl to preserve newlines.

Best Practices:

  • Write points in batches of 5,000 to 10,000 for optimal performance
  • Use the least precise timestamp precision possible for better compression

Parameters

Query parameters
db required string
Target database for the write
rp string
Target retention policy. If not specified, writes to the default retention policy.
precision string
Timestamp precision. InfluxDB assumes nanoseconds if not specified.
Allowed values: n , u , ms , s , m , h
Default: n
u string
Username for authentication
p string
Password for authentication

Request body required

Line protocol data. Multiple points should be separated by newlines. Use @filename to write from a file.
Content-Type: application/json
Example request Ask AI about this
curl --request POST \
  "http://localhost:8086/write?db=DB" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: text/plain" \
  --data-raw 'measurement,tag=value field=1.0'

Responses

204 Write successful
400 Bad request (line protocol syntax error or type conflict)
error required string
Error message
401 Unauthorized
error required string
Error message
404 Database not found
error required string
Error message
413 Request entity too large
error required string
Error message
500 Internal server error (e.g., retention policy not found)
error required string
Error message
POST /api/v2/write v2

Write data (v2 compatible)

Write data using the InfluxDB 2.x API format. This endpoint provides forward compatibility with InfluxDB 2.x client libraries.

Bucket Mapping: The bucket parameter maps to InfluxDB 1.x database and retention policy:

  • database/retention-policy - specific retention policy
  • database/ or database - default retention policy

The org parameter is ignored in InfluxDB 1.x.

Parameters

Query parameters
bucket required string
Database and retention policy in format database/retention-policy. Use database/ or database for the default retention policy.
org string
Organization (ignored in InfluxDB 1.x)
precision string
Timestamp precision
Allowed values: ns , us , ms , s
Default: ns

Request body required

Content-Type: application/json
Example request Ask AI about this
curl --request POST \
  "http://localhost:8086/api/v2/write?bucket=BUCKET" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: text/plain" \
  --data-raw 'measurement,tag=value field=1.0'

Responses

204 Write successful
400 Bad request
error required string
Error message
401 Unauthorized
error required string
Error message

Was this page helpful?

Thank you for your feedback!