Skip to main content
POST
/
x402
/
agent
/
set-uri
Prepare ERC-8004 agent URI update
curl --request POST \
  --url https://api.sandbox.brickken.com/x402/agent/set-uri \
  --header 'Content-Type: application/json' \
  --header 'X-Payment: <api-key>' \
  --data '
{
  "chainId": "8453",
  "signerAddress": "<string>",
  "gasLimit": "<string>",
  "nonce": 123,
  "privateRpcUrl": "<string>",
  "ownerEmail": "jsmith@example.com",
  "email": "jsmith@example.com",
  "agentUuid": "<string>",
  "agentId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "image": "<string>",
  "services": [
    {
      "name": "<string>",
      "endpoint": "<string>",
      "version": "<string>"
    }
  ],
  "metadata": {},
  "aiModelName": "<string>",
  "aiModelProvider": "<string>",
  "tags": [
    "<string>"
  ],
  "version": "<string>",
  "documentation": "<string>",
  "sourceCode": "<string>",
  "license": "<string>",
  "agentType": "<string>",
  "supportedTrust": [
    "<string>"
  ],
  "x402Support": true,
  "active": true,
  "registrations": [
    {}
  ]
}
'
{
  "transactions": {},
  "txId": "<string>",
  "info": {}
}
Prepares unsigned transactions for updating an ERC-8004 agent profile URI. This facade maps to agentSetURI.

​
Authentication

Omit x-api-key. If the API returns 402 Payment Required, sign the x402 payment locally and retry with X-Payment.

​
Key Fields

ParameterRequiredDescription
chainIdYesTarget chain ID. Decimal and hex values are accepted.
signerAddressYesWallet that signs the prepared transaction.
agentUuid or agentIdUsuallyAgent identifier from registration or the on-chain agent ID.
name, description, imageNoProfile fields used to build the updated URI metadata.
services, metadata, tagsNoAdditional agent profile metadata.
documentation, sourceCode, licenseNoPublic agent documentation and source metadata.

​
Response

Returns prepared unsigned transactions and txId. Sign the transaction locally, then submit it with POST /send-transactions.

Authorizations

​
X-Payment
string
header
required

Base64-encoded x402 payment payload. Supported for x402-eligible agentic methods on /x402/... facades, /prepare-transactions, and eligible /send-transactions retries.

Body

application/json
​
chainId
string
default:8453
required

Target operation chain ID. Use 8453 on production Base or 11155111 on sandbox Sepolia.

Example:

"8453"

​
signerAddress
string
required

Wallet that signs the prepared blockchain transaction.

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

Optional explicit gas limit.

​
nonce
number

Optional explicit nonce when managing nonces manually.

​
privateRpcUrl
string

Optional private RPC URL override.

​
ownerEmail
string<email>

Optional owner attribution email.

​
email
string<email>

Alias for ownerEmail where supported.

​
agentUuid
string

Stored tokenized agent UUID returned by agentRegister.

​
agentId
string

On-chain ERC-8004 agent ID.

​
name
string
​
description
string
​
image
string<uri>
​
services
object[]
​
metadata
object
​
aiModelName
string
​
aiModelProvider
string
​
tags
string[]
​
version
string
​
documentation
string<uri>
​
sourceCode
string<uri>
​
license
string
​
agentType
string
​
supportedTrust
string[]
​
x402Support
boolean
​
active
boolean
​
registrations
object[]

Response

Prepared unsigned transaction payload.

​
transactions
object
​
txId
string
​
info
object