# Heurist Vending Machine - Update Token Metadata

> Heurist Vending Machine - Update Token Metadata is a paid API for AI agents from vending-machine.heurist.xyz, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Updates the metadata (description, social links, image, docs) for an existing token on the Heurist Vending Machine, restricted to the token creator.

## Facts

- Endpoint: POST https://vending-machine.heurist.xyz/x402/metadata/update
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-vending-machine-update-token-metadata-4f5c5682
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N_N8nlwrikteSn36IQ_Hi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heurist-vending-machine-update-token-metadata-4f5c5682 -d '<json body>'
```

Example prompt: 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'.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Update token metadata. You must be the token creator to call this endpoint.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-vending-machine-update-token-metadata-4f5c5682/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vending-machine.heurist.xyz](https://www.zero.xyz/host/vending-machine.heurist.xyz/llms.txt)