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.

API keys

Each organization can have multiple API keys. Keys are created by owners or admins and authenticate requests to the REST API.
  • Keys use the format sk_test_*
  • Each key has its own rate limit (default: 1,000 req/hour)
  • Keys can be rotated or revoked at any time

Status

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