{"slug":"api-sandbox-brickken-com-x402-agent-set-metadata-c4dd88","title":"Prepare ERC-8004 metadata update","host":"api.sandbox.brickken.com","method":"POST","resource":"https://api.sandbox.brickken.com/x402/agent/set-metadata","category":"code","description":"Prepare ERC-8004 metadata update. Prepare an unsigned transaction that writes one ERC-8004 agent metadata key/value pair.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1311,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:84532"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"chainId":"84532","executionMode":"client-signed","signerAddress":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"properties":{"agentId":{"description":"On-chain ERC-8004 agent ID.","type":"string"},"agentUuid":{"description":"Stored tokenized agent UUID returned by agentRegister.","type":"string"},"aiModelName":{"type":"string"},"aiModelProvider":{"type":"string"},"chainId":{"default":"84532","description":"Target operation chain ID. This environment allows: 11155111, 84532, 80002.","examples":["84532","11155111","80002"],"type":"string"},"email":{"description":"Alias for ownerEmail where supported.","format":"email","type":"string"},"executionMode":{"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use brickken-relayed explicitly for Brickken signing and broadcasting, or client-broadcast to sign and broadcast locally. Client-controlled modes charge half at prepare and half at send; client-broadcast confirmation requires both txId and txHash.","enum":["client-signed","client-broadcast","brickken-relayed"],"type":"string"},"gasLimit":{"description":"Optional explicit gas limit.","oneOf":[{"type":"string"},{"type":"number"}]},"metadataEncoding":{"enum":["string","json","hex"],"type":"string"},"metadataKey":{"type":"string"},"metadataValue":{"oneOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}]},"nonce":{"description":"Optional explicit nonce when managing nonces manually.","type":"number"},"ownerEmail":{"description":"Optional owner attribution email.","format":"email","type":"string"},"signerAddress":{"description":"Required signer wallet for client-signed and client-broadcast execution.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["chainId","executionMode"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":1311,"error":null}],"description_full":"Prepare ERC-8004 metadata update. Prepare an unsigned transaction that writes one ERC-8004 agent metadata key/value pair.","last_updated":"2026-09-03T10:36:59.26Z","schemes":["exact"]}