Authentication

OAuth2 (Recommended)

Authenticate using the device flow — no client ID or secret needed:

groniz auth login

This will:

# Check who you're signed in as (verifies the credential is still valid)
groniz whoami

# Remove stored credentials
groniz auth logout

Alternatively, set your Groniz API key as an environment variable:

export GRONIZ_API_KEY=your_api_key_here

You can get your API key from the Groniz Settings page.

OAuth2 credentials take priority over the API key when both are present.

Variable	Required	Default	Description
`GRONIZ_API_KEY`	No*	-	Your Groniz API key
`GRONIZ_API_URL`	No	`https://api.groniz.com`	API endpoint override
`GRONIZ_AUTH_SERVER`	No	`https://api.groniz.com`	Auth server override

*Either OAuth2 (via groniz auth login) or GRONIZ_API_KEY is required.