# Register an agent without a pasted key

`POST /v1/agent-registrations`

**In this build:** Real.

**Scope:** None; this call is public

**CLI:** `harebox login --agent`

Send an `Idempotency-Key` header. A retry with the same key never repeats the action.

## Request: `AgentRegistrationRequest`

| Field | Type | Notes |
|---|---|---|
| `agent_name` (required) | `string` |  |
| `human_email` | `string or null` | Optional. The human who can claim the account. |

## Response: 201

`AgentRegistration`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `token` (required) | `string` | Shown once. Works immediately within anonymous limits. |
| `claim_url` (required) | `string` |  |
| `claim_code` | `string` | Shown once, at sign-up. Give it to your human with the claim URL; they enter it to claim the account. |
| `expires_at` | `string` | Unclaimed accounts and their sandboxes are removed after this time. |
| `limits` (required) | `Limits` |  |

Errors follow [one format](../errors.html).