{"uid":"cap_N_N8nlwrikteSn36IQ_Hi","slug":"heurist-vending-machine-update-token-metadata-4f5c5682","name":"Heurist Vending Machine - Update Token Metadata","description":"Update token metadata. You must be the token creator to call this endpoint.","url":"https://vending-machine.heurist.xyz/x402/metadata/update","method":"POST","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"docs":{"type":"string"},"token":{"type":"string","description":"The token contract address, starting with 0x"},"discord":{"type":"string"},"twitter":{"type":"string"},"website":{"type":"string"},"imageUrl":{"type":"string"},"telegram":{"type":"string"},"description":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v5xkj6b2o14AOA9eZJSSL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates the metadata (description, social links, image, docs) for an existing token on the Heurist Vending Machine, restricted to the token creator.","exampleAgentPrompt":"Update the metadata for my token at 0xAbC123... on Heurist Vending Machine — set the description to 'The future of decentralized AI compute', the website to 'https://mytoken.xyz', and the Twitter to '@mytokenxyz'.","exampleUseCases":[{"title":"Adding social links after launch","prompt":"I just launched a token at 0x1a2b3c... on the Heurist Vending Machine and forgot to add socials — can you update it with my Twitter '@heuristai', Discord 'https://discord.gg/heurist', and Telegram '@heuristchat'?"},{"title":"Updating token image and description","prompt":"Can you update my token 0xDEF456... on Heurist Vending Machine? Change the description to 'AI-powered compute marketplace token' and set the image URL to 'https://cdn.myproject.io/logo.png'."},{"title":"Adding documentation link to token","prompt":"Set the docs link for my token at 0x789abc... on the Heurist Vending Machine to 'https://docs.mytoken.io/whitepaper'."}],"resultDescription":"A confirmation that the token metadata has been updated on the Heurist Vending Machine. The updated fields (description, social links, imageUrl, website, docs) are now associated with the specified token contract address.","failureModes":["Not the token creator — only the creator wallet can update metadata, returns authorization error","Invalid or non-existent token contract address — returns error indicating token not found","Malformed imageUrl or website URL — may return validation error","Missing required 'token' field — returns 400 bad request","Payment failure — $1 USDC x402 payment not completed, returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to update or enrich the metadata of an already-launched token on the Heurist Vending Machine. This is specifically for post-launch metadata edits (social links, description, image, docs) and requires you to be the token creator. Not for purchasing tokens, launching new tokens, or querying token information.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:25.590Z","isFirstParty":false}