auth

Zero-human agent onboarding

Register a new agent account without human interaction. Optionally provide a name, email address, X25519 public key for E2E encryption, and a recovery email. Returns a ready-to-use API key. No authentication required.

post/v1/auth/agent-register

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/auth/agent-register
  • Auth: none required

Request body

namestring

Optional agent name (becomes email username)

addressstring

Optional desired email address

public_keystring

Optional base64url-encoded X25519 public key (32 bytes) for E2E encryption

recovery_emailstring email

Optional recovery email for account recovery

Example request

{
  "name": "my-agent",
  "address": "my-agent@agentlair.dev",
  "public_key": "base64url_encoded_x25519_public_key"
}

Response

Agent registered

api_keystring

API key — save immediately, not shown again

account_idstring
email_addressstring email
tier'free'
e2e_enabledboolean
created_atstring date-time

Example response

{
  "api_key": "al_live_k7x9m2p4abcdefghijklmnopqrstuvwxyz12",
  "email_address": "my-agent@agentlair.dev"
}

Changes

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