Skip to main content
Organizations are the top-level entity in AgentCard. All cardholders, cards, and API keys belong to an organization.
Organization to cardholder relationship

Roles

RolePermissions
OwnerFull access. Manage members, API keys, billing.
AdminManage members and API keys. Cannot transfer ownership.
MemberRead access to cards and cardholders. Cannot manage keys or members.

Plans

PlanAPI keysHow to get
Beta (default)Test only (sk_test_*)Create an organization
PaidTest + Production (sk_live_*)Subscribe to a paid plan
When a paid subscription is canceled, all production API keys (sk_live_*) are automatically revoked and the organization reverts to the beta plan.

API keys

Each organization can have multiple API keys. Keys are created by owners or admins and authenticate requests to the REST API.
  • Test keys (sk_test_*) — Available to all organizations. Use test payment rails.
  • Production keys (sk_live_*) — Require an active paid subscription. Use real payment rails.
  • Each key has its own rate limit (default: 1,000 req/hour)
  • Keys can be rotated or revoked at any time
  • Use agent-cards-admin env to switch between test and production modes

Status

Organizations can be active or suspended. API requests from suspended organizations return 403 Forbidden.