Nia Agent Onboarding

Set up Nia from any AI coding agent — no browser, no password. Your agent creates your account, verifies your email, and installs everything programmatically.

Quick Start

Paste this prompt into Claude Code, Cursor, Windsurf, or any AI coding agent:

You are an agent that is going to onboard me to Nia by Nozomio Labs. Please run `npx nia-wizard@latest agent-guide` to get the instructions, then create my account using the passwordless signup API, ask me for the email verification code, verify my account, install the CLI, and set up skills. After you are done, output a summary including the credentials so I can store them securely.

Do not forget to first ask me which email and organization name I would like to use.

Your agent will handle everything — you just provide your email, org name, and a 6-digit code from your inbox.

How It Works

1. Signup (no password)

curl -X POST https://apigcp.trynia.ai/v2/auth/signup \
 -H "Content-Type: application/json" \
 -d '{"email": "you@example.com", "organization_name": "My Org", "first_name": "Jane", "last_name": "Doe"}'

Response:

{
 "api_key": "nk_...",
 "api_key_id": "...",
 "user_id": "...",
 "organization_id": "...",
 "verified": false
}

The returned API key is read-only until verified. A 6-digit code is sent to your email.

2. Verify

curl -X POST https://apigcp.trynia.ai/v2/auth/verify \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer nk_..." \
 -d '{"code": "123456"}'

Response:

{
 "verified": true
}

Your API key is now full access — index repos, search, query, everything.

3. Install CLI & Skills

npm install -g @nozomioai/nia@latest
nia auth login --api-key nk_...
nia skill --all

Done. Nia is ready.

Returning Users

Already have an account? Log in without a password:

# Step 1: Request a code
curl -X POST https://apigcp.trynia.ai/v2/auth/login \
 -H "Content-Type: application/json" \
 -d '{"email": "you@example.com"}'

# Step 2: Verify and get a new API key
curl -X POST https://apigcp.trynia.ai/v2/auth/login/verify \
 -H "Content-Type: application/json" \
 -d '{"email": "you@example.com", "code": "123456"}'

Resend Code

If you didn't receive the verification email:

curl -X POST https://apigcp.trynia.ai/v2/auth/resend-code \
 -H "Authorization: Bearer nk_..."

API Reference

Endpoint	Method	Auth	Description
/v2/auth/signup	POST	None	Create account, get read-only key
/v2/auth/verify	POST	Bearer nk_...	Verify email, upgrade to full access
/v2/auth/login	POST	None	Send login code to email
/v2/auth/login/verify	POST	None	Verify code, get full-access key
/v2/auth/resend-code	POST	Bearer nk_...	Resend verification code

Permission Model

State	Can Search	Can Index	Can Delete
Unverified (read-only)	Yes	No	No
Verified (full access)	Yes	Yes	Yes

Rate Limits

Signup: 5 per IP/min, 3 per email/min
Login: 20 per IP/min, 5 per email/min
Verify: 20 per IP/min, max 10 attempts per code
Resend: 3 per key per 10 min
Verification codes expire after 15 minutes