Known Limits
This page is a quick index of the boundaries developers most often need to plan around. The full coverage and non-claim model lives on Scope and Limits.
Provider coverage
Provider operation coverage is not uniform. OpenAI has the broadest operation coverage; other providers focus on text generation and streaming with narrower coverage for advanced operations. See Provider Support and Scope and Limits § Provider coverage.
Routing
Routing is explicit and recorded; Keel does not perform autonomous fleet-wide selection. See Routing and Scope and Limits § Routing scope.
Replay and idempotency
Replay and idempotency guarantees are route-dependent — proxy routes have the strongest same-key replay binding; other routes are narrower. See Idempotency and Scope and Limits § Replay and idempotency.
Permit-first observation
When the caller executes downstream of POST /v1/permits, Keel records the decision but does not directly observe the provider call. Use the verification track to attach receipt evidence, or use a Keel-managed execution route when execution-bound enforcement matters. See Scope and Limits § Permit-first observation boundary.
Read/write governance coverage
Read/write governance applies to actions that route through Keel: model calls,
managed MCP :call invocations, Stripe MPP/x402 payments, exact Work connector
requests, and configured Vocal Bridge outbound calls. GitHub, files, email, Slack, customer
data, cloud, database, and code tools are Keel-enforced only when they are invoked
through an enrolled managed MCP contract. That includes the exact
stripe.refund.create contract as a beta/limited Stripe TEST path: Keel owns
dispatch to the enrolled server, while the customer adapter owns the final
Stripe call and TEST credential. It is not a general or live-mode Stripe refund
claim, and revision-bound automated certification is pending. The MCP decide and prepare routes
do not call upstream and require external enforcement. Browser/computer-use and
the session code-execution adapter are not released managed-execution claims;
the mounted browser and code routes dispatch only through an explicitly
configured executor and, with none configured, return 503 without
dispatching.
Direct off-path calls made with the agent’s own credentials are outside Keel’s
governance boundary. See
Read/Write Governance and
Scope and Limits § Read/write governance coverage.
Accounting precision
For complex multimodal traffic, pre-dispatch budget decisions can rely on heuristic token estimates and reconciliation closes the gap. When provider-final usage is missing, terminal accounting can remain estimated. See Scope and Limits § Accounting precision.
Content inspection
The Prompt Firewall is a deterministic detection layer for well-defined risk patterns, not a semantic prompt-injection defense. Coverage is route-scoped. See Prompt Firewall and Scope and Limits § Content inspection.
Trust tier differences
Audit and integrity features have a plan-tier ladder. See Trust & Integrity and Plans & Entitlements.
Out of scope today
- Realtime session APIs are documented but are not part of the official stable route inventory; their media and sidecar paths are evidence/decision surfaces, not a blanket voice-execution gate.
- Operator deployment internals.
See Scope and Limits § Out of scope today.
What to rely on
- Permit-first remains supported when the caller must retain provider transport.
- Public routes and request contracts documented on this site are the supported integration surface.
- Route-specific guarantees are intentional; do not generalize across surfaces.
- Undocumented behavior should not be treated as stable.
Related pages
- Scope and Limits — full coverage and non-claim model
- Read/Write Governance — action access policy and coverage boundaries
- API Guarantees — public-API stability commitments
- Quickstart
- API Reference
- Security
- Trust & Integrity