Documentation menu

API Reference

All endpoints are HTTPS, JSON, and authenticated with an API key (Authorization: Bearer <key>). Base URL https://api.scrywatch.com.

Authentication

Authenticate ScryWatch API requests with a per-project API key.

Ingest

Send events to ScryWatch over HTTP.

Logs & Search

Query log events, aggregate stats, facet counts, feature health, and filter values.

Sessions

List user sessions aggregated from log events.

Archive

Read raw log events directly out of R2 cold storage for a given day/hour.

Patterns

Recurring message templates aggregated across events, with hourly trend detail per fingerprint.

Snapshot

Real-time rollup of recent activity for a project: event counts, top services, top and new patterns, and an optional AI summary.

Issues

Deduplicated, grouped error and crash issues with occurrence history and a status workflow.

Alerts

Detection-only alert rules evaluated on a 5-minute cron, plus firing history. Notifications are delivered through the project's channels.

Deploys

Record deploy markers and compute before/after behavior diffs around a deploy.

Insights

AI-generated activity summaries, top error patterns, and AI digest delivery config.

Lenses

Saved filter presets for the log/event explorer.

Projects & API Keys

Create and list projects within an org, and manage the API keys used to authenticate against them.

Traces

Ingest distributed traces (native or OTLP), and list/inspect sampled traces and their spans.

Live Tail

Stream newly-ingested events for a project in real time over WebSocket.

MCP Server

Connect AI assistants to your ScryWatch project over the Model Context Protocol.

Health

Check whether the API and its storage bindings are reachable.