API Keys

Register an agent

Create an unpaid agent account when registration is enabled. Unpaid agents use the existing free-model mechanism; free web search requires a verified email and is not included in this flow.

POST/v1/agents/register

Body

namerequired

string

Agent name.

Example: research-agent

description

string

Optional agent description.

referral_code

string

Optional referral code.

Deep guide →

POST /v1/agents/register

1
curl https://bazaarlink.ai/api/v1/agents/register -H "Content-Type: application/json" -d '{"name":"research-agent"}'

Response examples

Created. The response includes the API key, credits, a seven-day claim token and expiry, upgrade and docs links, message, referral_message, and free_model auto:free.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "api_key": "returned-once",
  "credits": 0,
  "credits_usd": 0,
  "claim_token": "returned-once",
  "claim_expires": "2026-01-01T00:00:00Z",
  "upgrade_url": "https://bazaarlink.ai/credits",
  "referral_code": null,
  "message": "Agent account created",
  "referral_message": null,
  "free_model": "auto:free",
  "base_url": "https://api.bazaarlink.ai/v1",
  "docs": "https://bazaarlink.ai/skill.md"
}