---
title: "Register Agent"
method: POST
path: "/v1/agent/register"
---

# Register Agent

`POST /v1/agent/register`

## Request

- Base URL: `https://agentpay.tools` (the document declares no server; this is the origin it was published from)
- URL: `https://agentpay.tools/v1/agent/register`
- Auth: none required

Mint a fresh wallet + session token. Free, no payment.

Returns the wallet (the agent keeps its own secret), a session_token, the
list of free tools it can call immediately, and pointers to the next two
calls. Designed so an agent goes from zero to a free tool call without any
human step.

## Request body

- AgentRegisterRequest
  - `label` string, nullable
  - `network` string
  - `max_spend` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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