Restormel Connect API

Wire agents and apps to a workspace-scoped knowledge graph. After ingest builds your corpus, these endpoints serve retrieval and verification — the production layer between your documents and your AI products.

Public REST lives on restormel.dev under /connect/v1/*. Authenticate with a Gateway key (rk_…) and include a Keys workspace_id on every request body.

Endpoints

  • POST /connect/v1/verify — Connect Verify (@restormel/reasoning-core)
  • POST /connect/v1/retrieve — Connect Retrieve (@restormel/graphrag-core)
  • POST /connect/v1/ingest/jobs — create ingest job (workspace-scoped persistence)
  • GET /connect/v1/ingest/jobs — list jobs for a workspace
  • GET /connect/v1/ingest/jobs/{jobId} — job status and stage progress

Contract

Request/response envelopes use CONNECT_API_CONTRACT_VERSION = 2026-06-01 from @restormel/contracts/connect. OpenAPI draft: openapi-suite-v1-draft.yaml.

MCP tools

@restormel/mcp registers connect.verify, connect.retrieve, connect.ingest.start, and connect.ingest.status. Set RESTORMEL_CONNECT_API_BASE + RESTORMEL_GATEWAY_KEY to proxy verify/retrieve to hosted REST from MCP.

Operator hub

Signed-in operators: /keys/dashboard/connect.

Related