{"uid":"cap_zqbu0rFkccOnau1UaEcH8","slug":"8k4-protocol-upload-erc-8004-agent-metadata-3afeee51","name":"8k4 Protocol — Upload ERC-8004 Agent Metadata","description":"Upload signed ERC-8004 metadata","url":"https://api.8k4protocol.com/agents/%7Bagent_id%7D/metadata","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"uri":"https://api.8k4protocol.com/metadata/base/21480.json","chain":"base","agent_id":21480}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wXuie4sqWlO1Sl0Sr964G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Upload signed ERC-8004 metadata for a specific agent to register or update its on-chain trust profile","exampleAgentPrompt":"Upload the signed ERC-8004 metadata for agent ID 21480 on the Base chain to the 8k4 Protocol so it gets a trust profile URI.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the metadata URI where the agent's metadata is now hosted (e.g. https://api.8k4protocol.com/metadata/base/21480.json), the chain name (e.g. 'base'), and the agent_id that was registered.","failureModes":["Invalid or missing agent_id returns a 400 or 404 error","Unsigned or malformed ERC-8004 metadata payload causes a validation rejection","Signature verification failure returns an authorization error","Duplicate metadata upload for same agent may conflict or overwrite depending on protocol rules","Payment of 0.1 USDC not received results in x402 payment required error","Unsupported chain identifier causes a chain resolution error"],"whenToPreferThis":"Use this endpoint when you need to register or update a signed ERC-8004 metadata record for a specific AI agent on the 8k4 Protocol trust network. This is the write operation for agent metadata — use sibling endpoints for reading trust scores, score explanations, or validation history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:22.421Z","isFirstParty":false}