Tailstream Tailstream

API Overview

The Tailstream API enables you to push logs and manage streams in a secure, resilient manner. This guide covers the high‑level concepts and links to detailed references for endpoints and ingest setup.

Getting Started

  1. Authentication - Learn about tokens and security
  2. Ingest API - Send log events to Tailstream
  3. Streams API - Manage event streams and tokens

Rate Limiting & Backpressure

Tailstream protects the platform with per‑organisation limits:

  • Request rate limits return 429 with Retry-After headers
  • Backpressure on ingest queues also yields 429 responses
  • Stream connection attempts are similarly limited

Data Retention & Replay

Historical data is stored in TimescaleDB. Redis is used only as a small live buffer for SSE.

Integration Guides