Write Time Series Data

Writing Points to a Measurement

If you're writing data points through the Historian API, it's important to understand how InfluxDB stores time series data. We recommend reviewing the Data modelData model, especially the section on choosing between tags and fields. Misusing tags—for example, storing high-cardinality or numeric values—can have serious performance implications.

This code writes data points to a measurement (my Swagger). It requires a CollectorUUID and MeasurementUUID to be filled in. The collector UUID can be retrieved by listing the collectors. The measurement UUID can be retrieved from where it was created: Manage Measurements.

POST https://historian.mycompany.com:18000/api/collector/collectors/\\\{collector\\\_uuid}/points (replace {collector_uuid} with your collector UUID)

def write_points(collector_uuid: str, points):
    url = f"{BASE_URL}/collector/collectors/{collector_uuid}/points"
    resp = session.post(url, json=points, timeout=60)
    resp.raise_for_status()
    return resp.json()

points = [{
        "MeasurementUUID": "my-measurement-uuid",
        "Timestamp": "2025-09-19T12:41:33.854Z",
        "Value": "string"  # First point
    },
    {
        "ErrorStatus": "This is a bad status!",
        "MeasurementUUID": "my-measurement-uuid",
        "Tags": {},
        "Timestamp": "2025-09-19T12:42:30.854Z",
        "Value": "bad string"  # Second point
}]

write_result = write_points("my-collector-uuid", points)
print(json.dumps(write_result, indent=2))

Write Time Series Data

Writing Points to a Measurement

Successful response