Get the caller's org mu-engine balance
Returns the mu (metered-unit) ledger balance for the authenticated caller's organization, augmented with enforcement status if the org runs enforce-configured agents (MNE-6915). Requires JWT auth; RBAC is enforced by api before forwarding — the caller must be a member of the target org (defaults to their primary org; an explicit org_id query targets a specific org and a non-member is denied 403). api resolves the org's billing_account_id server-side, queries the org's agents to determine enforcement configuration, and augments the upstream mnemom-mu balance response with effectiveMode ('enforce' | 'passthrough') and enforcementPausedReason ('balance_depleted' | null) before returning. A client-supplied account id is never used. 503 when the mnemom-mu binding/URL is unconfigured (fail-closed).
Request
- Base URL: https://api.mnemom.ai/v1
- URL: https://api.mnemom.ai/v1/billing/mu
- Auth: HTTP bearer
Query parameters
Target org id. Defaults to the caller's primary org. A caller who is not a member of this org is denied 403.
Optional product scope (sub-projects, contract C5). Omitted → today's response, unchanged. This is an ACCOUNT-level resource (one shared μ wallet; purchases, grants and balances are not product-scoped), so a product value does NOT narrow the figures. The response body is returned unchanged and LABELLED with product_scope: { scope: "account", requested_product } (plus an X-Mnemom-Product-Scope: account response header) so a client can never mistake an account figure for a per-product one. all labels requested_product: "all". Applied AFTER auth/org/RBAC, so it can never widen access. Any value outside the enum → 400 invalid_product.
Response
mu ledger balance for the org with enforcement status augmentation. Response includes all upstream mnemom-mu balance fields plus optional enforcement fields (effectiveMode, enforcementPausedReason) if the org runs enforce-configured agents.
Changes
No recorded changes to this operation across all 1 revision of this API.