Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

CLI Authentication

Manage authentication from the command line.

Authentication Commands

Login

# Interactive login (prompts for all inputs)
pinner auth
 
# Provide email, prompt for password and OTP if needed
pinner auth --email user@example.com
 
# Non-interactive with environment variables
PINNER_EMAIL=user@example.com PINNER_PASSWORD=yourpassword pinner auth
 
# With 2FA code
PINNER_EMAIL=user@example.com PINNER_PASSWORD=yourpassword PINNER_OTP=123456 pinner auth
 
# Provide API token directly
pinner auth YOUR_API_TOKEN
 
# Create a named API key
pinner auth --email user@example.com --key-name "my-laptop"

Register

# Interactive mode (prompts for all required fields)
pinner register
 
# Non-interactive with flags
pinner register --email user@example.com --first-name John --last-name Doe

Confirm Email

pinner confirm --email user@example.com --tokenabc123def456

account

Manage your Pinner.xyz account settings:

# Enable 2FA
pinner account otp enable
 
# Enable 2FA with OTP code (non-interactive)
pinner account otp enable --otp 123456
 
# Disable 2FA
pinner account otp disable
 
# Disable 2FA with password (non-interactive)
pinner account otp disable --password mypassword