REST API

Authenticated planning, execution, follows, feed, and artifact retrieval.

The current API is intentionally small and product-shaped. Use bearer auth or `x-api-key`, start with entity search, then move into plan, execute, and persisted artifacts.

Auth header

Authorization: Bearer YOUR_TOKEN

Core routes

Method	Path	Purpose
GET	/api/auth/me	Resolve current auth context and plan code.
GET	/api/billing/config	Read billing-provider readiness and available priced plans.
POST	/api/billing/checkout-session	Create a public checkout session when billing is configured.
GET	/api/billing/session/:sessionId	Reconcile a completed checkout session and reveal the issued token when available.
GET	/api/entities/search	Search live gold entities.
GET	/api/catalog/search	Search cataloged data sources.
POST	/api/plan	Persist a plan from one user query.
POST	/api/execute	Execute a query and persist an artifact.
POST	/api/chat	One-call chat surface over the same planner backend.
GET	/api/follows	Read persisted follow rows.
GET	/api/feed	Read live feed events.