---
title: Write data
description: Write data to InfluxDB 3 Cloud using line protocol format.
url: https://docs.influxdata.com/influxdb3/cloud/api/write-data/
estimated_tokens: 748
product: InfluxDB 3 Cloud
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud/api/write-data/
---

[Download InfluxDB 3 Cloud API Spec](/openapi/influxdb3-cloud-openapi.yml)

Write data to InfluxDB 3 Cloud using line protocol format.

POST`/api/v3/write_lp`

### Write line protocol

Writes line protocol to the specified database.

This is the native InfluxDB 3 Cloud write endpoint that provides enhanced control
over write behavior with advanced parameters for high-performance and fault-tolerant operations.

Use this endpoint to send data in [line protocol](/influxdb3/cloud/reference/syntax/line-protocol/) format
to InfluxDB. Use query parameters to specify options for writing data.

#### Features

* **Partial writes**: Use `accept_partial=true` to allow partial success when some lines in a batch fail
* **Asynchronous writes**: Use `no_sync=true` to skip waiting for WAL synchronization, allowing faster response
  times but sacrificing durability guarantees
* **Flexible precision**: Automatic timestamp precision detection with `precision=auto` (default)

#### Column families

InfluxDB 3 Cloud stores data using PachaTree. Assign fields to column
families using the `::` delimiter in field names. The portion before`::` is the family name; everything after is the field name.

```txt
metrics,host=sA cpu::usage_user=55.2,cpu::usage_sys=12.1,mem::free=2048i 1000000000
```

Fields in the same family are stored together on disk. For wide tables, this reduces I/O
by letting queries read only the families they need. Fields written without `::` are assigned
to auto-generated families.

#### Auto precision detection

When you use `precision=auto` or omit the precision parameter, InfluxDB 3 automatically detects
the timestamp precision based on the magnitude of the timestamp value:

* Timestamps \< 5e9 → Second precision (multiplied by 1,000,000,000 to convert to nanoseconds)
* Timestamps \< 5e12 → Millisecond precision (multiplied by 1,000,000)
* Timestamps \< 5e15 → Microsecond precision (multiplied by 1,000)
* Larger timestamps → Nanosecond precision (no conversion needed)

#### Related

* [Use the InfluxDB v3 write\_lp API to write data](/influxdb3/cloud/write-data/http-api/v3-write-lp/)

#### Parameters

##### Query parameters

`db`requiredstring

`precision`string

`accept_partial`boolean

`no_sync`boolean

#### Request body

Content-Type:`application/json`

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://cluster-host.a.influxdb.io/api/v3/write_lp?db=DB" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: text/plain" \
  --data-raw 'measurement,tag=value field=1 1234567890'
```

#### Responses

204Success (“No Content”). All data in the batch is written and queryable.

400Bad request.

401Unauthorized access.

`data`object

`error`string

403Access denied.

413Request entity too large.

422Unprocessable entity.

#### Related

* [Write data using HTTP APIs](/influxdb3/cloud/write-data/http-api/)
* [InfluxDB 3 API client libraries](/influxdb3/cloud/reference/client-libraries/v3/)
