Usage, plans & limits

Oka meters usage so you only pay for what your team actually consumes. Current rates and plan caps live on the pricing page; this page explains the mechanics.

What gets metered

Four meters are customer-facing:

Meter	Unit	What counts
Model tokens	tokens	LLM tokens consumed by chat and the PM agent (input + output, provider-reported)
API calls	calls	Direct REST requests to the platform and Reason APIs
Knowledge searches	queries	Semantic search, context ranking, and reasoning queries
Storage	MB	Durable bytes your knowledge occupies (learnings, embeddings, events, memory)

A fifth meter, consolidation runs, is tracked internally for cost containment and is not surfaced on customer plans.

One action, one charge

MCP tool calls are billed as the REST requests they make under the hood — a semantic_search tool call is one knowledge search, an observe is one API call. There is no separate per-tool charge, and the same action is never counted twice.

Chat and PM agent conversations are billed by model tokens only. The knowledge lookups the agent performs on your behalf are part of that conversation, not extra searches.

Hard caps and the 402

Model tokens, API calls, and knowledge searches are hard caps: when your plan’s monthly allowance is exhausted, further requests receive:

HTTP 402 Payment Required
{
  "error": "plan_limit_exceeded",
  "limit_type": "api_calls",
  "current_usage": 10000,
  "max_allowed": 10000
}

Treat a 402 as terminal for the current billing period — retrying won’t succeed. Upgrade your plan from the dashboard or wait for the period to reset. Allowances renew automatically each billing month (Free plans renew monthly at no charge).

Storage is a soft cap

Storage never blocks writes. A daily snapshot records how many MB your knowledge occupies; if your billing period’s peak exceeds your plan’s included storage, the overage is added to your next invoice at the per-MB rate on the pricing page. Deleting data lowers future snapshots immediately — you are billed on the period peak, not on a running total.

Where to see your usage

The dashboard’s Usage This Period panel shows each meter’s current consumption against your plan limit. Storage shows the latest snapshot (your actual current footprint), not a cumulative sum.