Skip to main content
The MuBit data plane exposes low-level memory primitives. It is powerful and intentionally policy-constrained. Use direct-core methods only when you need an explicitly enabled compatibility lane such as direct semantic search. For most app request paths, control-plane methods are safer and easier to operate. Keeping this boundary clear reduces policy and reliability incidents.

Core route families

FamilyRepresentative routes
Direct retrieval/v2/core/search
Health/auth/v2/core/health, /v2/core/auth/*

Policy behavior

  • /v2/core/search requires MUBIT_CORE_ENABLE_DIRECT_SEARCH.
  • Other external /v2/core/* routes should be treated as compatibility-only or policy-denied, not normal SDK adoption paths.

Failure modes and troubleshooting

SymptomRoot causeFix
Core calls are deniedDirect lanes disabledUse control path or enable lane deliberately
Retrieval behavior diverges unexpectedlyMixed control/core usageDefine one default retrieval path
Operational overhead increasesBroad direct-core adoptionRestrict direct-core to targeted features

Next steps