Skip to main content
POST
Register agent (x402 + AgentRegistry)

Body

application/json
vault
string
required

Genesis vault contract address

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x0000000000000000000000000000000000000001"

name
string
required
Required string length: 1 - 128
Example:

"Alpha Bot"

metadataURI
string
required
Required string length: 1 - 2048
Example:

"ipfs://alpha-bot"

signer
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
deadline
string
required

Unix timestamp; EIP-712 SelfRegister deadline

Pattern: ^\d+$
signature
string
required

EIP-712 signature from signer

Pattern: ^0x[a-fA-F0-9]*$
erc8004AgentId
string
default:0

ERC-8004 identity token id when linking

Pattern: ^\d+$

Response

Registration accepted

agentId
string | null
required
transactionHash
string | null
required
Pattern: ^0x[a-fA-F0-9]*$
transaction
object | null
required
message
string
required