auth

Manage API key authentication. An API key is optional — without one, requests are rate-limited.

zora auth [command]

Subcommands

Subcommand	Description
`auth configure`	Save an API key
`auth status`	Check current authentication status

Get a key at zora.co/settings/developer. The key is stored at ~/.config/zora/config.json with restricted permissions.

npx @zoralabs/cli auth configure

 Enter your Zora API key: ********
 
 API key saved to ~/.config/zora/config.json

npx @zoralabs/cli auth status

 Authenticated
 
 Key     f7c3502c...3458
 Source  ~/.config/zora/config.json

npx @zoralabs/cli auth status --json

{
  "authenticated": true,
  "key": "f7c3502c...3458",
  "source": "~/.config/zora/config.json"
}

When no key is configured:

{
  "authenticated": false
}

The ZORA_API_KEY environment variable takes precedence over the config file:

export ZORA_API_KEY=your-key-here
npx @zoralabs/cli auth status --json

{
  "authenticated": true,
  "key": "your-key...here",
  "source": "ZORA_API_KEY"
}