Skip to main content
POST
/
agents
/
register
Build a register-agent transaction
curl --request POST \
  --url https://api.x84.ai/agents/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-research-agent",
  "ownerAddress": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
  "metadataUri": "https://arweave.net/abc123",
  "tags": [
    "research",
    "defi"
  ]
}
'
{
  "transaction": "<string>",
  "assetPublicKey": "<string>",
  "agentPda": "<string>",
  "blockhash": "<string>",
  "lastValidBlockHeight": 123
}

Body

application/json
name
string
required

Agent name (max 64 characters)

Maximum string length: 64
Example:

"my-research-agent"

ownerAddress
string
required

Owner wallet address (base58)

Example:

"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu"

metadataUri
string
required

Metadata URI (max 200 characters)

Maximum string length: 200
Example:

"https://arweave.net/abc123"

tags
string[]

Agent tags (max 5)

Maximum array length: 5
Example:
["research", "defi"]

Response

Partially-signed transaction returned

transaction
string

Base64-encoded serialized transaction

assetPublicKey
string

NFT mint public key (base58)

agentPda
string

Agent identity PDA (base58)

blockhash
string
lastValidBlockHeight
number