Tailstream

API Reference

Complete reference for all Tailstream API endpoints.

Authentication

All API requests require authentication. See the Authentication Guide for details on token types and usage.

API Categories

Ingest API

Send log events to Tailstream.

  • POST /api/ingest/{streamId} - Send log events

Streams API

Manage event streams and view ingest credentials.

  • POST /api/streams - Create a new stream
  • GET /api/streams/{stream} - Retrieve a stream
  • GET /api/streams/{stream}/logs - List raw logs with typed filters, time-range controls, and pagination

Response Codes

All endpoints use standard HTTP status codes:

  • 200 - Success
  • 201 - Created successfully
  • 400 - Bad request (malformed data)
  • 401 - Missing or invalid authentication
  • 403 - Insufficient permissions
  • 404 - Resource not found
  • 422 - Validation error
  • 429 - Rate limit exceeded (includes Retry-After header)

Getting Started

  1. Start with Authentication to understand token types
  2. Follow the Ingest Setup Guide to send your first logs
  3. Explore individual endpoint documentation for detailed request/response formats