Stream API

The customer Stream API base is https://stream.fluxtail.io/api/v1.

Download the Stream OpenAPI document

Authentication

Every customer request needs a Bearer token and its verified account:

Authorization: Bearer YOUR_TOKEN
X-Active-Account: YOUR_ACCOUNT_UUID

/logs needs logs:read. Histogram and facet routes need analytics:read. Responses are private and not browser-cacheable.

Read logs

GET /api/v1/logs?streamId=STREAM_UUID&limit=100&search=timeout

Important filters include sinceTime, untilTime, severity, host, serviceName, serviceNamespace, repeatable label=key:value, and Kubernetes fields. Use since for newer logs and cursor for older logs. limit is 1 to 1000.

{
  "logs": [],
  "cursor": {
    "timestamp": "2026-07-28T12:00:00.000Z",
    "logId": "00000000-0000-0000-0000-000000000000"
  }
}

Histogram

GET /api/v1/histogram?startTime=...&endTime=...&buckets=60

startTime and endTime are required. buckets defaults to 60 and cannot exceed 500. Successful responses contain the requested number of start-relative buckets, including zero-count buckets, for [startTime, endTime).

Facets

GET /api/v1/facets?field=service_name&topK=10
GET /api/v1/facets/batch?fields=severity,host,service_name&topK=15

Supported fields include severity, host, service, stream, and Kubernetes dimensions. topK cannot exceed 100 on the single-facet route. A failed request is an HTTP error, not an empty success.