Core Concepts
The minimum object model behind the docs and SDK examples.
You do not need the full platform model to integrate Valmar. These are the concepts that show up repeatedly in the SDKs and docs.
UI vs API names
A few backend models still have older internal names. The Admin UI, SDKs, MCP tools, and these docs use the product names:
- People in the UI and SDK map to backend
Memberrecords. - Knowledge Requests in the UI and SDK map to backend
KnowledgeRequestrecords. - Knowledge Items in the SDK map to backend
KnowledgeItemrecords.
Terms to know
Organization
The tenant boundary for people, projects, and reusable knowledge.
Project
The application or workflow scope that owns credentials, requests, and saved knowledge.
Person
A real employee or operator that Valmar can contact for missing context.
Shown as People in the Admin UI and exposed as people in the SDKs.
Knowledge Request
A tracked request created when your app cannot answer confidently.
Created through knowledge_requests in Python, knowledgeRequests in TypeScript,
and create_knowledge_request in MCP.
Knowledge Item
A reusable saved answer that can be searched later with provenance and confidence metadata.