LVNGDocs
API ReferenceSDKslvng.ai

Knowledge

The Knowledge Master API is a unified layer integrating all knowledge subsystems: document parsing with semantic chunking, audio intelligence, workflow memory, git/code intelligence, and the Neo4j knowledge graph. It provides cross-system search, insights, and analytics through a single API surface.

Base path: /api/knowledge|Version: v1|Auth: JWT (except health)|Rate limit: 100 req/min
This is a v1 API mounted at /api/knowledge (not /api/v2). Sub-APIs for documents, audio, workflows, and code are mounted under this path (e.g., /api/knowledge/documents, /api/knowledge/audio).

Health Check

GET/api/knowledge/health

Master health check that probes all knowledge subsystems: knowledge graph (Neo4j), documents, audio, workflows, and code. Returns overall status as 'healthy' if all subsystems pass, or 'degraded' if any fail. Does not require authentication.

Request

cURL
400">curl -X 400">GET https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/health

Response 200

{
  400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
  400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-19T10:00:00.000Z",
  400">class="text-emerald-400">"version": 400">class="text-emerald-400">"1.0.0",
  400">class="text-emerald-400">"subsystems": {
    400">class="text-emerald-400">"knowledgeGraph": {
      400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
      400">class="text-emerald-400">"connected": true,
      400">class="text-emerald-400">"latency": 12
    },
    400">class="text-emerald-400">"documents": {
      400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
      400">class="text-emerald-400">"documentCount": 347
    },
    400">class="text-emerald-400">"audio": {
      400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
      400">class="text-emerald-400">"voiceNotes": 0
    },
    400">class="text-emerald-400">"workflows": {
      400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
      400">class="text-emerald-400">"enabled": true
    },
    400">class="text-emerald-400">"code": {
      400">class="text-emerald-400">"status": 400">class="text-emerald-400">"healthy",
      400">class="text-emerald-400">"filesAnalyzed": 1284
    }
  },
  400">class="text-emerald-400">"crossSystem": {
    400">class="text-emerald-400">"enabled": true,
    400">class="text-emerald-400">"queryService": 400">class="text-emerald-400">"active"
  }
}

Unified Statistics

GET/api/knowledge/statsAuthenticated

Returns aggregate statistics across all knowledge subsystems via the CrossSystemQueryService.

Request

cURL
400">curl -X 400">GET https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/stats \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"documents": {
    400">class="text-emerald-400">"total": 347,
    400">class="text-emerald-400">"byType": { 400">class="text-emerald-400">"pdf": 124, 400">class="text-emerald-400">"markdown": 98, 400">class="text-emerald-400">"text": 82, 400">class="text-emerald-400">"html": 43 },
    400">class="text-emerald-400">"totalChunks": 4821
  },
  400">class="text-emerald-400">"audio": {
    400">class="text-emerald-400">"totalRecordings": 89,
    400">class="text-emerald-400">"totalDurationMinutes": 412,
    400">class="text-emerald-400">"transcribed": 76
  },
  400">class="text-emerald-400">"workflows": {
    400">class="text-emerald-400">"totalExecutions": 2341,
    400">class="text-emerald-400">"memoryCaptured": 1856
  },
  400">class="text-emerald-400">"code": {
    400">class="text-emerald-400">"filesAnalyzed": 1284,
    400">class="text-emerald-400">"repositories": 5,
    400">class="text-emerald-400">"totalCommits": 3472
  },
  400">class="text-emerald-400">"knowledgeGraph": {
    400">class="text-emerald-400">"totalNodes": 8734,
    400">class="text-emerald-400">"totalRelationships": 24561,
    400">class="text-emerald-400">"concepts": 1247
  }
}

Ingest Content

POST/api/knowledge/ingestAuthenticated

Unified ingestion endpoint that auto-routes content to the appropriate subsystem based on the type field. Text content is semantically chunked and stored in the Neo4j knowledge graph. Documents are parsed and embedded. Supported types: text, document_url, voice_transcription, meeting_transcript, code_snippet, git_commits, workflow_execution.

Body Parameters

typestringrequired

Content type to ingest. One of: text, document_url, voice_transcription, meeting_transcript, code_snippet, git_commits, workflow_execution.

datastring | objectrequired

The content to ingest. Format depends on type: plain text for "text", URL string for "document_url", structured objects for others.

metadataobject
Default: {}

Additional metadata. Supports category, source, chunkSize (for text), language (for code), repoPath (for git_commits).

Request

cURL
400">curl -X 400">POST https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/ingest \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY" \
  -H 400">class="text-emerald-400">"Content-Type: application/json" \
  -d '{
    400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"text",
    400">class="text-emerald-400">"data": 400">class="text-emerald-400">"Remote work policy: All team members may work remotely up to 3 days per week. Core hours are 10am-3pm EST. Managers must approve schedules by Friday for the following week.",
    400">class="text-emerald-400">"metadata": {
      400">class="text-emerald-400">"category": 400">class="text-emerald-400">"policies",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"hr-handbook",
      400">class="text-emerald-400">"chunkSize": 500
    }
  }'

Response 201

{
  400">class="text-emerald-400">"success": true,
  400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"text",
  400">class="text-emerald-400">"result": {
    400">class="text-emerald-400">"id": 400">class="text-emerald-400">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    400">class="text-emerald-400">"chunkCount": 2
  },
  400">class="text-emerald-400">"message": 400">class="text-emerald-400">"Content ingested successfully"
}

Cross-System Search

POST/api/knowledge/searchAuthenticated

Searches across all knowledge subsystems simultaneously using the CrossSystemQueryService. Returns results with per-source breakdowns and aggregations.

Body Parameters

querystringrequired

The search query string.

sourcesstring[]
Default: ["all"]

Which subsystems to search. Pass "all" to search everything.

limitnumber
Default: 20

Maximum results to return.

filtersobject
Default: {}

Additional filters to narrow results.

Request

cURL
400">curl -X 400">POST https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/search \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY" \
  -H 400">class="text-emerald-400">"Content-Type: application/json" \
  -d '{
    400">class="text-emerald-400">"query": 400">class="text-emerald-400">"authentication flow implementation",
    400">class="text-emerald-400">"sources": [400">class="text-emerald-400">"all"],
    400">class="text-emerald-400">"limit": 10
  }'

Response 200

{
  400">class="text-emerald-400">"query": 400">class="text-emerald-400">"authentication flow implementation",
  400">class="text-emerald-400">"sources": [400">class="text-emerald-400">"all"],
  400">class="text-emerald-400">"results": [
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"b2c3d4e5-f6a7-8901-bcde-f12345678901",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"code",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"auth-middleware.js",
      400">class="text-emerald-400">"content": 400">class="text-emerald-400">"JWT verification and role-based access control implementation...",
      400">class="text-emerald-400">"score": 0.94,
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"code"
    },
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"c3d4e5f6-a7b8-9012-cdef-123456789012",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"document",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Authentication Architecture",
      400">class="text-emerald-400">"content": 400">class="text-emerald-400">"The platform uses JWT-based authentication with refresh token rotation...",
      400">class="text-emerald-400">"score": 0.89,
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"documents"
    }
  ],
  400">class="text-emerald-400">"total": 2,
  400">class="text-emerald-400">"breakdown": {
    400">class="text-emerald-400">"code": 1,
    400">class="text-emerald-400">"documents": 1,
    400">class="text-emerald-400">"audio": 0,
    400">class="text-emerald-400">"workflows": 0
  },
  400">class="text-emerald-400">"aggregations": {}
}

Knowledge Timeline

GET/api/knowledge/timelineAuthenticated

Returns a unified chronological view of knowledge events across all subsystems. Events include document ingestions, transcriptions, workflow executions, code commits, and concept discoveries.

Query Parameters

sincestring

ISO 8601 start date for the timeline.

untilstring

ISO 8601 end date for the timeline.

typesstring
Default: all

Comma-separated content types to include. Pass "all" for everything.

limitnumber
Default: 50

Maximum events to return.

granularitystring
Default: day

Time grouping granularity: hour, day, week, or month.

Request

cURL
400">curl -X 400">GET 400">class="text-emerald-400">"https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/timeline?since=2026-03-12T00:00:00Z&until=2026-03-19T23:59:59Z&granularity=day&limit=20" \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"timeline": [
    {
      400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-19T14:30:00.000Z",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"document",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"API Design Guidelines v2",
      400">class="text-emerald-400">"action": 400">class="text-emerald-400">"ingested",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"documents"
    },
    {
      400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-19T10:15:00.000Z",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"voice_transcription",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Sprint retro thoughts",
      400">class="text-emerald-400">"action": 400">class="text-emerald-400">"transcribed",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"audio"
    },
    {
      400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-18T16:45:00.000Z",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"code",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"feat: add calendar availability endpoint",
      400">class="text-emerald-400">"action": 400">class="text-emerald-400">"committed",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"code"
    }
  ],
  400">class="text-emerald-400">"summary": {
    400">class="text-emerald-400">"totalEvents": 3,
    400">class="text-emerald-400">"bySource": { 400">class="text-emerald-400">"documents": 1, 400">class="text-emerald-400">"audio": 1, 400">class="text-emerald-400">"code": 1 }
  },
  400">class="text-emerald-400">"filters": {
    400">class="text-emerald-400">"since": 400">class="text-emerald-400">"2026-03-12T00:00:00Z",
    400">class="text-emerald-400">"until": 400">class="text-emerald-400">"2026-03-19T23:59:59Z",
    400">class="text-emerald-400">"types": 400">class="text-emerald-400">"all"
  }
}

Cross-System Insights

GET/api/knowledge/insightsAuthenticated

Generates AI-powered insights and correlations across all knowledge subsystems. Analyzes patterns, identifies knowledge gaps, and surfaces connections between documents, code, meetings, and workflows.

Query Parameters

timeWindowstring
Default: P30D

ISO 8601 duration for the analysis window (e.g., P7D for 7 days, P30D for 30 days).

depthnumber
Default: 2

Depth of relationship traversal in the knowledge graph.

Request

cURL
400">curl -X 400">GET 400">class="text-emerald-400">"https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/insights?timeWindow=P7D&depth=2" \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"insights": [
    {
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"correlation",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Calendar integration discussed across 3 systems",
      400">class="text-emerald-400">"description": 400">class="text-emerald-400">"The 'calendar integration' topic appeared in meeting transcripts, code commits, and 2 documents this week.",
      400">class="text-emerald-400">"confidence": 0.92,
      400">class="text-emerald-400">"sources": [400">class="text-emerald-400">"audio", 400">class="text-emerald-400">"code", 400">class="text-emerald-400">"documents"]
    },
    {
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"knowledge_gap",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Missing documentation for voice notes API",
      400">class="text-emerald-400">"description": 400">class="text-emerald-400">"Code changes to voice-notes-api.js have no corresponding documentation updates.",
      400">class="text-emerald-400">"confidence": 0.78,
      400">class="text-emerald-400">"sources": [400">class="text-emerald-400">"code", 400">class="text-emerald-400">"documents"]
    }
  ],
  400">class="text-emerald-400">"timeWindow": 400">class="text-emerald-400">"P7D",
  400">class="text-emerald-400">"generatedAt": 400">class="text-emerald-400">"2026-03-19T10:30:00.000Z"
}

Find Related Content

POST/api/knowledge/relatedAuthenticated

Finds content related to a given item by traversing the knowledge graph. Returns results grouped by content type with relevance scores.

Body Parameters

contentIdstringrequired

The ID of the source content to find relations for.

contentTypestringrequired

The type of the source content (e.g., document, code, audio, workflow).

maxDepthnumber
Default: 2

Maximum relationship traversal depth in the graph.

limitnumber
Default: 10

Maximum related items to return.

Request

cURL
400">curl -X 400">POST https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/related \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY" \
  -H 400">class="text-emerald-400">"Content-Type: application/json" \
  -d '{
    400">class="text-emerald-400">"contentId": 400">class="text-emerald-400">"b2c3d4e5-f6a7-8901-bcde-f12345678901",
    400">class="text-emerald-400">"contentType": 400">class="text-emerald-400">"document",
    400">class="text-emerald-400">"maxDepth": 2,
    400">class="text-emerald-400">"limit": 5
  }'

Response 200

{
  400">class="text-emerald-400">"contentId": 400">class="text-emerald-400">"b2c3d4e5-f6a7-8901-bcde-f12345678901",
  400">class="text-emerald-400">"contentType": 400">class="text-emerald-400">"document",
  400">class="text-emerald-400">"related": [
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"code",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"auth-middleware.js",
      400">class="text-emerald-400">"score": 0.87,
      400">class="text-emerald-400">"relationship": 400">class="text-emerald-400">"IMPLEMENTS"
    },
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"audio",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Architecture review - auth flow",
      400">class="text-emerald-400">"score": 0.72,
      400">class="text-emerald-400">"relationship": 400">class="text-emerald-400">"DISCUSSES"
    }
  ],
  400">class="text-emerald-400">"count": 2,
  400">class="text-emerald-400">"byType": {
    400">class="text-emerald-400">"code": 1,
    400">class="text-emerald-400">"audio": 1
  }
}

Cross-Reference

POST/api/knowledge/cross-referenceAuthenticated

Finds cross-references between a source item and target content types. Example: find all code files related to a meeting transcript, or all documents related to a workflow execution.

Body Parameters

sourceTypestringrequired

The type of the source content.

sourceIdstringrequired

The ID of the source content.

targetTypesstring[]
Default: []

Content types to cross-reference against.

querystring

Optional text query to further filter cross-references.

Request

cURL
400">curl -X 400">POST https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/cross-reference \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY" \
  -H 400">class="text-emerald-400">"Content-Type: application/json" \
  -d '{
    400">class="text-emerald-400">"sourceType": 400">class="text-emerald-400">"audio",
    400">class="text-emerald-400">"sourceId": 400">class="text-emerald-400">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    400">class="text-emerald-400">"targetTypes": [400">class="text-emerald-400">"code", 400">class="text-emerald-400">"document"],
    400">class="text-emerald-400">"query": 400">class="text-emerald-400">"calendar integration"
  }'

Response 200

{
  400">class="text-emerald-400">"source": {
    400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"audio",
    400">class="text-emerald-400">"id": 400">class="text-emerald-400">"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  400">class="text-emerald-400">"references": [
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"f6a7b8c9-d0e1-2f3a-4b5c-6d7e8f9a0b1c",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"code",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"calendar-api.js",
      400">class="text-emerald-400">"score": 0.91
    },
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"a7b8c9d0-e1f2-3a4b-5c6d-7e8f9a0b1c2d",
      400">class="text-emerald-400">"400">type": 400">class="text-emerald-400">"document",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Calendar Integration Design Doc",
      400">class="text-emerald-400">"score": 0.85
    }
  ],
  400">class="text-emerald-400">"count": 2,
  400">class="text-emerald-400">"byType": {
    400">class="text-emerald-400">"code": 1,
    400">class="text-emerald-400">"document": 1
  }
}

Concept Mentions

GET/api/knowledge/concept/:name/mentionsAuthenticated

Tracks all mentions of a named concept across every knowledge subsystem. Returns mentions grouped by source with a timeline view.

Path Parameters

namestringrequired

The concept name to track (e.g., "authentication", "rate-limiting").

Query Parameters

limitnumber
Default: 50

Maximum mentions to return.

Request

cURL
400">curl -X 400">GET 400">class="text-emerald-400">"https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/concept/authentication/mentions?limit=10" \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"concept": 400">class="text-emerald-400">"authentication",
  400">class="text-emerald-400">"mentions": [
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"b8c9d0e1-f2a3-4b5c-6d7e-8f9a0b1c2d3e",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"code",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"auth-middleware.js",
      400">class="text-emerald-400">"context": 400">class="text-emerald-400">"JWT verification and role-based access control...",
      400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-18T16:45:00.000Z"
    },
    {
      400">class="text-emerald-400">"id": 400">class="text-emerald-400">"c9d0e1f2-a3b4-5c6d-7e8f-9a0b1c2d3e4f",
      400">class="text-emerald-400">"source": 400">class="text-emerald-400">"documents",
      400">class="text-emerald-400">"title": 400">class="text-emerald-400">"Security Architecture Overview",
      400">class="text-emerald-400">"context": 400">class="text-emerald-400">"The authentication layer uses JWT tokens with...",
      400">class="text-emerald-400">"timestamp": 400">class="text-emerald-400">"2026-03-15T11:00:00.000Z"
    }
  ],
  400">class="text-emerald-400">"total": 2,
  400">class="text-emerald-400">"bySource": {
    400">class="text-emerald-400">"code": 1,
    400">class="text-emerald-400">"documents": 1,
    400">class="text-emerald-400">"audio": 0,
    400">class="text-emerald-400">"workflows": 0
  },
  400">class="text-emerald-400">"timeline": [
    { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-18", 400">class="text-emerald-400">"count": 1 },
    { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-15", 400">class="text-emerald-400">"count": 1 }
  ]
}

Knowledge Velocity

GET/api/knowledge/analytics/velocityAuthenticated

Measures the rate of knowledge acquisition across all subsystems over time. Useful for tracking team learning patterns and identifying periods of high or low knowledge creation.

Query Parameters

timeWindowstring
Default: P30D

ISO 8601 duration for the analysis window.

granularitystring
Default: day

Time bucketing: hour, day, week, or month.

systemsstring
Default: all

Comma-separated subsystems to include, or "all".

Request

cURL
400">curl -X 400">GET 400">class="text-emerald-400">"https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/analytics/velocity?timeWindow=P7D&granularity=day" \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"velocity": {
    400">class="text-emerald-400">"trend": 400">class="text-emerald-400">"increasing",
    400">class="text-emerald-400">"averagePerDay": 12.4,
    400">class="text-emerald-400">"buckets": [
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-13", 400">class="text-emerald-400">"count": 8 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-14", 400">class="text-emerald-400">"count": 15 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-15", 400">class="text-emerald-400">"count": 6 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-16", 400">class="text-emerald-400">"count": 3 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-17", 400">class="text-emerald-400">"count": 18 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-18", 400">class="text-emerald-400">"count": 14 },
      { 400">class="text-emerald-400">"date": 400">class="text-emerald-400">"2026-03-19", 400">class="text-emerald-400">"count": 23 }
    ],
    400">class="text-emerald-400">"bySystem": {
      400">class="text-emerald-400">"documents": 34,
      400">class="text-emerald-400">"code": 28,
      400">class="text-emerald-400">"audio": 12,
      400">class="text-emerald-400">"workflows": 13
    }
  },
  400">class="text-emerald-400">"timeWindow": 400">class="text-emerald-400">"P7D",
  400">class="text-emerald-400">"granularity": 400">class="text-emerald-400">"day"
}

Analytics Dashboard

GET/api/knowledge/analytics/dashboardAuthenticated

Returns a pre-computed analytics dashboard with key metrics, trends, and summaries across the entire knowledge system.

Query Parameters

timeWindowstring
Default: P7D

ISO 8601 duration for the dashboard data window.

Request

cURL
400">curl -X 400">GET 400">class="text-emerald-400">"https:400">class="text-zinc-500">//api.lvng.ai/api/knowledge/analytics/dashboard?timeWindow=P7D" \
  -H 400">class="text-emerald-400">"Authorization: Bearer YOUR_API_KEY"

Response 200

{
  400">class="text-emerald-400">"summary": {
    400">class="text-emerald-400">"totalKnowledgeItems": 8734,
    400">class="text-emerald-400">"newThisWeek": 87,
    400">class="text-emerald-400">"activeSubsystems": 5,
    400">class="text-emerald-400">"topConcepts": [400">class="text-emerald-400">"authentication", 400">class="text-emerald-400">"calendar", 400">class="text-emerald-400">"voice-notes", 400">class="text-emerald-400">"workflows", 400">class="text-emerald-400">"api-design"]
  },
  400">class="text-emerald-400">"activity": {
    400">class="text-emerald-400">"documents": { 400">class="text-emerald-400">"400">new": 12, 400">class="text-emerald-400">"updated": 8 },
    400">class="text-emerald-400">"audio": { 400">class="text-emerald-400">"recorded": 5, 400">class="text-emerald-400">"transcribed": 4 },
    400">class="text-emerald-400">"code": { 400">class="text-emerald-400">"commits": 42, 400">class="text-emerald-400">"filesChanged": 67 },
    400">class="text-emerald-400">"workflows": { 400">class="text-emerald-400">"executed": 23, 400">class="text-emerald-400">"memoryCaptured": 19 }
  },
  400">class="text-emerald-400">"health": {
    400">class="text-emerald-400">"knowledgeGraph": 400">class="text-emerald-400">"healthy",
    400">class="text-emerald-400">"documents": 400">class="text-emerald-400">"healthy",
    400">class="text-emerald-400">"audio": 400">class="text-emerald-400">"healthy",
    400">class="text-emerald-400">"workflows": 400">class="text-emerald-400">"healthy",
    400">class="text-emerald-400">"code": 400">class="text-emerald-400">"healthy"
  },
  400">class="text-emerald-400">"timeWindow": 400">class="text-emerald-400">"P7D",
  400">class="text-emerald-400">"generatedAt": 400">class="text-emerald-400">"2026-03-19T10:30:00.000Z"
}