Blinq Docs

Reference

Server API

The Blinq server API is what powers the dashboard and the widget. Most of it requires an authenticated dashboard session; the public surface is intentionally tiny.

Public endpoints

  • GET /pub/integrate-blinq-widget.md — Markdown version of the install guide consumed by AI agents. Mirrors /install.
  • POST /api/public/widget/session/init — bootstraps a widget session. Accepts identity_token for verified users.

Dashboard endpoints (auth required)

Use the same cookie session as the dashboard. CSRF-safe per browser context. Some highlights:

  • GET /api/widget/snippet
  • POST /api/widget/identity-secret
  • GET /api/conversations
  • GET /api/conversations/{session_id}/timeline — agent run timeline events for a conversation.
  • GET /api/analytics/conversations/insights?range=7d
  • GET /api/suggestions/candidates?range_days=30&limit=10 — auto-discovered scenario candidates mined from recent conversations.

Full OpenAPI spec: /openapi.json.