auth & status
Authenticate to an Emend server and inspect org identity, storage, and health.
emend auth / emend status
Two related groups cover authentication and server identity:
auth— save, inspect, and clear local credentials in~/.emend/.env.status— check that the server is reachable and reports the expected identity.
emend auth login
Save authentication credentials to ~/.emend/.env. The file is created with restricted permissions.
emend auth login [--api-key <key>] [--server-url <url>]| Prop | Type |
|---|---|
--api-key | str |
--server-url | str |
If neither flag is passed, nothing is written and the command prints a hint.
emend auth login \ --api-key sk-emend-... \ --server-url https://www.emend.onlineemend auth status
Print the current credentials as seen by the CLI. The API key is masked.
emend auth statusOutput lists the resolved URL, the masked API key, and the path to the env file it was loaded from.
emend auth logout
Delete the stored credentials by removing ~/.emend/.env.
emend auth logoutemend status check
Make a GET /health request and report whether the server is reachable and healthy.
emend status checkExits with code 1 if the server cannot be reached or returns a non-2xx status.
emend status whoami
Show who you are on the server and where your data lands. Calls GET /api/whoami and reports the org ID, resolved storage type, masked storage label, and whether storage is configured. Use this to sanity-check that you're pointing at the right backend.
emend status whoamiwhoami reports self-host-org for your org ID on a remote server, auth is not being enforced — the CLI is effectively hitting a shared default namespace. Contact the server operator.