--identity. Reached as vetta identity card <command> — three words, where card is a sub-group rather than a positional argument. See Cards for the model and the Cards API for the wire shapes.
--usd takes a decimal such as 50 or 12.99; the CLI converts once to the integer micro-USD the API speaks (50 → 50000000).
Commands
--identity takes either an idn_ id or the persona’s name; the API resolves both. On a deployment with no card issuer bound, quote, issue, retry and reveal answer 501 feature_not_configured. There is no assign/unassign: an agent whose session selects the persona holds its cards.
list / quote / issue
issue debits the quoted price from the organization’s credits before anything is ordered; a short balance answers 402 insufficient_credits. Without --wait the card is printed as issued — usually issuing — and show reads it again.
show / reveal / retry / cancel / refund
reveal is the only command that prints a card number; every call is recorded as card.credentials_revealed, and a card that is not active answers 404 not_found. A lifecycle action from the wrong status answers state_conflict. A prepaid card cannot be topped up — issue another.
transactions / spend
Logging a spend that would exceed the card’s load is refused with
validation_failed.