DriftQ logo
DriftQ

HTTP Endpoints

The DriftQ-Core HTTP API surface.

This page lists the current DriftQ-Core HTTP endpoints. Most endpoints are under /v1.

Note: /v1/consume streams responses as NDJSON until the client disconnects.

Health

GET /v1/healthz

Topics

GET  /v1/topics
POST /v1/topics?name=t&partitions=1

Produce

POST /v1/produce?topic=t&value=hello

Consume (streaming)

GET /v1/consume?topic=t&group=g&owner=o&lease_ms=5000

Response is NDJSON: newline-delimited JSON items streamed until the client disconnects.

Ack / Nack

POST /v1/ack?topic=t&group=g&owner=o&partition=0&offset=0
POST /v1/nack?topic=t&group=g&owner=o&partition=0&offset=0&error=some_reason