/api/account endpoints. Each row below links to its API page, which has the full request and response shapes.
Subcommands
show
Print the configured account as JSON — display name, creation date, active owners and admins, and the current subscription summary (when present).account:read.
Rendering price after a discount
RenderdiscountedDisplayPrice ?? displayPrice to match the web app’s billing page. v2 (Stripe-native) plans may omit discountedDisplayPrice even when a discount is present — fall back to displayPrice and surface the discount summary for context.
rename
Rename the configured account. Prints the current → new transition and prompts for confirmation; pass--yes (or -y) to skip.
Optional flags:
Required scope:
account:write. The endpoint is allowlist-only — accountName is the single field accepted; any other key in the body is rejected with 400.
Renames emit an accountUpdated EventBridge event with actor: cli:{apiKeyPk} so downstream consumers can distinguish UI vs API-key mutations.
settings order show
Print the account’s order settings as JSON: count flags for pending and voided orders, refund-date attribution, and the exclusion filters that drop matching orders from the web app’s reports.Saved order settings aren’t applied to CLI or API queries. The query endpoints only use an
orderSettings object passed in the request, and the CLI’s query commands don’t send one. If you have exclusion filters or count pending or voided orders, CLI results can differ from the app.account:read. When the account has no stored orderSettings, the response is filled with the same defaults the web app uses (countPendingOrders=false, countVoidedOrders=false, refundDateAttribution=refund_date, exclusionFilters=[]).
settings order set
PUT-the-whole-config semantics. The file you pass replaces the storedorderSettings in its entirety — any existing filter not present in the file is deleted. The server assigns id, createdAt, and updatedAt on new filters (and on nested groups + conditions); entries that already carry an id preserve their createdAt and get a bumped updatedAt.
--yes skips the prompt.
Required flags:
Optional flags:
Example body — “drop POS orders” filter, every
id optional:
account:write. Strict allowlist at every nesting level — extra keys in the body, or in a filter, group, or condition are rejected with 400. Operators must be valid for the chosen field type per ORDER_EXCLUSION_FIELD_CATALOG (e.g. greater_than on sourceName → 400).
Updates emit an accountUpdated EventBridge event with actor: cli:{apiKeyPk} and change: { kind: "orderSettings" }.