API Reference

Full REST API reference for LogFlow. Base URL: https://api.getlogflow.com

ℹ️
All endpoints require Authorization: Bearer lf_YOUR_API_KEY header.

Logs

POST
/v1/logs

Ingest a single log entry

POST
/v1/logs/batch

Ingest up to 1000 logs in one request

GET
/v1/logs/search

Search and filter logs with pagination

GET
/v1/logs/stats

Aggregate stats: totals, error rate, by-hour breakdown

GET
/v1/logs/stream

Server-Sent Events stream for live tail

GET
/v1/logs/context

Fetch logs before/after a specific log entry

Projects

GET
/v1/projects

List all projects in your organization

POST
/v1/projects

Create a new project

PATCH
/v1/projects/:id

Update project name, description, or settings

DELETE
/v1/projects/:id

Delete a project and all its data

Alerts

GET
/v1/alerts

List alerts for a project

POST
/v1/alerts

Create a new alert

PATCH
/v1/alerts/:id

Update alert or toggle enabled/disabled

DELETE
/v1/alerts/:id

Delete an alert

Anomalies

GET
/v1/anomalies

List detected anomaly events (with optional unresolved filter)

Issues (Error Grouping)

GET
/v1/issues

List error groups (open/muted/resolved)

PATCH
/v1/issues/:id

Update status: open | resolved | muted

POST
/v1/issues/:id/ai-summary

Generate AI summary for an error group

Deployments

GET
/v1/deployments

List recent deployments

POST
/v1/deployments

Record a new deployment

DELETE
/v1/deployments/:id

Delete a deployment marker

Record deployment example

bash
curl -X POST https://api.getlogflow.com/v1/deployments \
  -H "Authorization: Bearer lf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "v1.4.2",
    "service": "api",
    "environment": "production",
    "description": "Fix payment retry logic"
  }'

OpenTelemetry

POST
/v1/otlp/v1/logs

OTLP/HTTP JSON log ingestion (OpenTelemetry)