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.
People in the API
People in the Admin UI and SDKs are represented by Member records in the
backend API.
Terms to know
Organization
The tenant boundary for people, projects, and reusable context.
Project
The application or workflow scope that owns credentials, requests, and context resources.
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.
Context Request
A tracked request created when your app cannot answer confidently.
Created through context_requests in Python, contextRequests in TypeScript,
and request_context in MCP.
Unstructured Context Resource
A reusable saved answer that can be searched later with provenance, confidence, source expert, and approval metadata.