Which credential they need
Every command on this page that sends a request needs the command-line login fromanona login --cli,
except plain anona usage (your credit balance), which an API key can read too.
Only the exports commands take --space.
An API key or a temporary profile gets exit 4 with session_required:
anona login --cli and still get session_required,
an API key is set: --api-key, ANONA_API_KEY or ~/.anona/config.env outranks
the login. Unset the key, or run the command without it, to use the login.
The credential matrix, and the fixed list of routes a CLI login may call, is in
Authentication.
Your role and organization are read from your membership on every request, so
being removed or demoted applies to the CLI within 30 seconds.
Reading the account
usage with no flag is unchanged: your credit balance, which an API key can
also read (profile, user-profile, usage). Two flags turn
it into a history, and these need anona login --cli:
Invitations
pending lists what is waiting on you, with each invitation’s token.
accept prints Joined <org>. (or the space you were given access to);
decline prints Declined.. Accepting checks that your signed-in email is the
invited address, so a forwarded token does not hand over the seat.
Exports
exports create prints Export <job_id> started.; exports list
prints <job_id> <status> <created_at>; exports download saves the file and
prints Saved <bytes> bytes to <FILE>..
The file comes from a short-lived download link. If the link has expired or its
storage refuses it, the command exits 7 and prints
anona: download link expired or refused (HTTP <status>); run download again.
Running exports download again asks for a fresh link.
--json: create prints {"job_id", "space_id", "status", "created_at"},
list prints {"items": [...], "total"}, and download prints
{"job_id", "path", "bytes"}, written by the CLI after saving the file.
Done in the dashboard
Anything that creates, changes or spends is not a CLI command. These print one line to stderr, send nothing, and exit4:
The verb in the sentence (
upgrading your plan, renaming the organization, …)
follows the command you typed. Any further arguments, and --yes, are accepted
and ignored: the command still sends nothing and exits 4. Listing a
space’s members is a CLI command: see spaces members list.