Skip to main content

Authentication

The Nexudus CLI authenticates against the Nexudus REST API using your Nexudus account email and password. Credentials are stored securely in your operating system’s native credential store.

Credential storage

Credentials are never stored in plain text on disk.

Log in

The CLI prompts you for your Nexudus email and password. After entering them, the CLI validates your credentials by calling the Nexudus API and stores them securely if successful.
The admin CLI currently uses Basic Authentication (username and password). OAuth/Bearer token support is planned for a future release.

Public API Authentication

In addition to admin authentication, the CLI supports the Public API, which lets you authenticate as a member of a coworking space. Public API tokens are stored separately from admin credentials, so you can use both contexts simultaneously.

Log in as a member

Verify your member session

Log out as a member

This only clears public API (member) credentials — your admin credentials remain unaffected. For the full reference of public API commands, see Public API Commands.

Verify your session

This displays your authenticated user information including your name, email, and default business. It also returns useful defaults that commands use automatically: These defaults are used automatically when creating or updating entities so you don’t have to specify them every time.

Log out

This clears all stored credentials from your system’s secure storage.

Troubleshooting authentication

Run nexudus doctor at any time to check whether you have stored credentials and whether the API is reachable.