Onboarding Guide

User Journey Overview

Register Account  ->  Create Organization  ->  Subscribe to Data  ->  Pull Data via API

Time to first data pull: ~5 minutes.

Organization creation is optional during signup — you can skip it and set up your org later from Settings → Organization.

Step 1: Register Your Account

1a. Get Started

Visit developer.humanbased.ai and click Get Started. You can also sign up with GitHub or HuggingFace OAuth for one-click access.

1b. Create Your Account

Enter your company email and click Send verification code. You'll also see OAuth options for GitHub and HuggingFace above the email form.

1c. Verify and Set Up Profile

1. Check your inbox for a 6-digit OTP from noreply@humanbased.ai
2. Enter the code and click Verify
3. Set your full name and password — a real-time strength indicator shows whether you've met all requirements (uppercase, lowercase, number, and special character)
4. Click Create account

Already have an account? Use the Sign in page instead.

Step 2: Create Your Organization

After account creation, you enter a 3-step organization setup wizard. This step is optional — click Skip on the first screen to proceed directly to the dashboard and set up your org later from Settings → Organization.

2a. Organization Info

Fill in your organization details and click Continue:

2b. Invite Team Members (optional)

This step is optional — click Do this later to skip it entirely. You can always invite members later via Settings > Team.

If you do invite now, add colleagues by email and assign a role plus fine-grained permissions:

Each role can be further customised with individual permission toggles:

2c. Get Started

After setup, you'll see two options for your next step:

• Browse available datasets — go to the Subscriptions page to see what data verticals are available
• Create your first API key — go to the API Keys page to generate a key for authenticating your requests

No API key is created automatically — you create keys on your own terms from the API Keys page, with a name, expiry, and scoped subscriptions that you control.

Step 3: Explore the Dashboard

The dashboard is your central hub — it shows your balance, active API keys, subscription status, and a live data stream.

Sidebar Navigation

Sandbox vs. Production

The toggle at the top of every page controls which environment you're working in:

• Sandbox — simulated data, no charges, safe for testing
• Production — real crowd-sourced data, metered billing

Step 4: Subscribe to Data Sources

You must subscribe to at least one data vertical before your API key can pull data.

4a. Browse Data Frontiers

Navigate to Subscriptions in the sidebar and switch to Production mode. Available data frontiers are displayed as cards.

Each frontier card shows:

• Name and description (e.g., CEX Hot Wallet, Food Science)
• Tags (crypto, on-chain, exchange, etc.)
• Task count and total submissions
• Status badge: Live (actively collecting) or Historical

Use the Live / Historical filter and category tags to narrow results.

4b. Subscribe

1. Click Subscribe on the frontier you need
2. Review and accept the data usage agreement (7-clause terms)
3. The subscription activates immediately

Once subscribed, all organization members automatically receive access — no per-user setup needed.

Step 5: Pull Data via API

Using the Dashboard

1. On your active subscription card, click Pull Data
2. The panel shows your subscription ID, status, and a ready-to-use curl command

The data table displays recent submissions with:

• DATA — annotation content and metadata
• QUALITY — confidence score (0-1)
• GRADE — quality tier (S, A, B, C, D)
• PRICE — per-record cost
• STATUS — pending / adopted / disputed

Using curl

curl -s "https://api.humanbased.ai/v1/live/pull?subscription_id=YOUR_SUBSCRIPTION_ID&cursor=0" \
     -H "Authorization: Bearer YOUR_API_KEY"

Using the CLI

npm install -g @humanbased/cli
hb auth set-key hb_live_sk_...
hb data pull --subscription YOUR_SUBSCRIPTION_ID --cursor 0

Pagination

• cursor=0 starts from the earliest records
• Increment the cursor to fetch newer batches
• Each response includes the next cursor value

Step 6: Review Submissions

After pulling data, you can provide feedback on each submission.

Accept a submission (adopt):

curl -X POST "https://api.humanbased.ai/v1/live/items/SUBMISSION_ID/adopt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subscription_id": "YOUR_SUB_ID"}'

Flag for re-review (dispute):

curl -X POST "https://api.humanbased.ai/v1/live/items/SUBMISSION_ID/dispute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subscription_id": "YOUR_SUB_ID", "reason": "Incorrect label"}'

You can also adopt and dispute directly from the Dashboard Overview live stream in the UI. Records arrive as "pending" and are auto-adopted after 48 hours unless disputed.

Managing API Keys

Create additional keys from the API Keys page for different environments or team members.

Settings

Organization

Update your org name, URL slug, billing email, backup email, and logo from Settings → Organization.

Logo files are uploaded directly to Supabase storage (max 2 MB). Changing the slug updates your org's public URL (humanbased.ai/<slug>).

Team Members

Manage your team from Settings → Team. View all current members with their roles, invite new colleagues by email, and manage pending invitations.

Account

Update your display name and email from Settings → Account. You can also permanently delete your account — this removes all memberships, API keys, and org data in a multi-step process.

Quick Reference