API

API

Tinybird-compatible. Existing client code works by changing only TINYBIRD_HOST. Bearer token in Authorization: Bearer <tok>.

Ingest

Method	Path	Scope
POST	/v0/events?name={datasource}	APPEND:<ds> / ADMIN

NDJSON body, batched by the Gatherer. Invalid rows are quarantined.

Query published pipes

Method	Path	Notes
GET	/v0/pipes/{name}.json	+ .csv, .ndjson, .parquet
POST	/v0/pipes/{name}/copy	run a copy pipe into its target datasource

Extra query params bind to the pipe's {{Type(param)}} template vars — as ClickHouse query parameters, never string-interpolated. Scope: READ:<pipe>.

Ad-hoc SQL

Method	Path	Scope
GET / POST	/v0/sql	ADMIN, read-only (readonly=2)

Introspection

GET /v0/datasources · /v0/datasources/{name} · /v0/pipes · /v0/pipes/{name}

Ops & docs

GET /health · /health/ready · /v0/metrics (Prometheus) · /tr/v1/openapi.json · /tr/v1/docs (when TR_DOCS_ENABLED=1)

Try it fast

Import the ready-made collection into Postman or Bruno: examples/tinyraven.postman_collection.json — set host + token, run.