---
title: "Zero-human agent onboarding"
method: POST
path: "/v1/auth/agent-register"
tags: ["auth"]
---

# Zero-human agent onboarding

`POST /v1/auth/agent-register`

## Request

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

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.

## Request body

- object
  - `name` string: Optional agent name (becomes email username)
  - `address` string: Optional desired email address
  - `public_key` string: Optional base64url-encoded X25519 public key (32 bytes) for E2E encryption
  - `recovery_email` string, email: Optional recovery email for account recovery

## Response `201`

Agent registered

- object
  - `api_key` string: API key — save immediately, not shown again
  - `account_id` string
  - `email_address` string, email
  - `tier` 'free'
  - `e2e_enabled` boolean
  - `created_at` string, date-time

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/agentlair/apis/agentlair-api.md) · [All operations](https://skmtc.dev/agentlair/apis/agentlair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlair/apis/agentlair-api/revisions/fac95ff4995d?raw)