Docs

Hosted API Reference

This is a pragmatic reference for the most-used FusionLayer endpoints. The canonical interface for most integrations is the SDK, but the API is stable and can be used directly.

SDK reference API base URL

Authentication

Server-side clients typically authenticate with an API key. Browser sessions use cookies and do not rely on long-lived tokens in response bodies.

Method	Path	Description	Auth
POST	/auth/register	Create an account and bootstrap credentials.	None
POST	/auth/login	Exchange email/password for session credentials (cookie or tokens).	None
GET	/me	Return the authenticated user profile.	Required

Capture

Capture ingests vendor/tool events as an envelope and stores them according to the user’s privacy mode.

Method	Path	Description	Auth
POST	/v1/capture	Ingest a single capture envelope.	Required
POST	/v1/capture/batch	Bulk ingest capture events (deduplicated by capture id).	Required

// Example payload (simplified)
POST /v1/capture
{
  "envelope": {
    "uacp_version": "1",
    "capture_id": "uuid",
    "source": { "vendor": "cursor", "client": "my-app", "client_version": "1.2.3" },
    "kind": "capture",
    "tags": ["dev"],
    "content": "Explain the auth flow",
    "context_hint": "auth module discussion"
  }
}

Recall

Recall performs semantic search across saved context and returns ranked results for rehydration.

Method	Path	Description	Auth
POST	/v1/recall	Semantic recall for cross-vendor conversation and artifact retrieval.	Required

Artifacts

Public defaults are available without authentication. User-specific artifact CRUD is exposed through other routes and the SDK surface.

Method	Path	Description	Auth
GET	/api/artifacts/defaults	Return the system default per artifact kind.	None