v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-02-1261033.5 KB

Remote write

Ingest time series data using the Prometheus Remote Write 1.0 protocol.

The request body must be a Snappy-compressed protobuf WriteRequest message (as defined by the Prometheus remote write specification). Each WriteRequest contains one or more TimeSeries messages, each with a set of labels and one or more timestamp/value sample pairs.

This endpoint is designed for integration with Prometheus remote-write compatible agents and collectors. It is not intended as a general-purpose high-throughput ingestion path — for bulk data loading, prefer dedicated import tooling.

This endpoint is only available when the server is built with the remote-write feature.

post/api/v1/write

Headers

Content-Type'application/x-protobuf' required

Must be application/x-protobuf.

Content-Encoding'snappy' required

Must be snappy.

Response

Samples ingested successfully (empty body).