Account

Create an account and API key in one call

For AI agents. Returns a working API key in this one call: no password and no email click before the first order. Send the email address of the person you are acting for; they receive a verification link. An address that already has an account is refused (registration_failed): its owner makes a key under Settings, API Keys. Until the address is verified the account is limited to a small free allowance (see allowance). Limits: 30 requests per hour and 20 accounts per day per IP.

post/agents/register

Request

Base URL: https://barevalue.com/api/v1
URL: https://barevalue.com/api/v1/agents/register
Auth: none required

Request body

emailstring email required

Email address of the person the account is for

first_namestring

last_namestring

agent_namestring

Name of the agent or app creating the account

refstring

Optional code of the listing or link the agent came from, as printed in that listing's install instructions (e.g. docker). Lowercase letters, digits and hyphens. A value of any other shape is ignored and never causes a refusal. Also read from ?ref= on the request address.

Response

Account created and API key issued

api_keystring

Shown once. Send as Authorization: Bearer <api_key>.

key_prefixstring

messagestring

next_stepsstring[]

mcp_urlstring

docsstring

Example response

{
  "api_key": "bv_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "allowance": {
    "reason": "email_not_verified",
    "rate": {
      "orders_at_once": 1,
      "minutes_per_window": 120,
      "window_hours": 5
    }
  },
  "mcp_url": "https://barevalue.com/mcp"
}

Changes

No recorded changes to this operation across all 1 revision of this API.