Skip to content
API Reference

How Transactions Work

Understanding Keycard's billing model

A transaction is recorded each time Keycard is involved in a tool call - issuing a credential, validating a request, or handling a step-up approval. Every plan includes a monthly allocation of transactions. See Pricing for plan details.

How often Keycard participates in the request path depends on how your resources are connected.

Keycard is involved in both issuing and validating the agent’s credential, providing per-request policy enforcement and real-time telemetry. Each tool call generates a transaction.

This applies to resources protected via the SDK, the gateway, or the CLI.

Keycard issues a credential that the agent uses to directly access a downstream application. Once the credential is issued, Keycard is no longer involved in the request path. Only the initial issuance generates a transaction - subsequent calls go straight to the service.

This is the pattern for third-party services like GitHub, Slack, and Google Workspace, connected via access credential providers.

When policy requires human approval for a sensitive action, that approval generates a transaction. Routine actions proceed without interruption.

PatternTransactions
Agent calls tools on a protected resource1 per tool call
Agent accesses a brokered resource1 at issuance, then none
Agent exchanges a credential for a different resource1 per exchange
Sensitive action triggers human approval1 per approval