# Radio WithZero Link Code Redemption

> Radio WithZero Link Code Redemption is a paid API for AI agents from radio.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-14).

Redeems a single-use link code to merge the current purchasing channel into the buyer account that minted the code.

## Facts

- Endpoint: POST https://radio.withzero.xyz/api/v1/buyer/links
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-radio-withzero-link-code-redemption-79fba4ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5g-fcs8S7kWiwwBP_-w7U

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 radio-withzero-xyz-radio-withzero-link-code-redemption-79fba4ef -d '<json body>'
```

Example prompt: I minted a link code on my other channel and I want to connect this purchasing channel to that buyer account — can you redeem link code 'ABC123XYZ' here on radio.withzero to merge them?

## When to prefer this

Use this endpoint when an agent or user needs to consolidate multiple purchasing channels under a single buyer account on radio.withzero, specifically by presenting a time-limited code generated via the companion 'mint link code' endpoint. This is the correct endpoint for account merging/linking — not for authentication, login, or creating a new buyer account from scratch.

## Known failure modes

- Expired code (link codes are single-use and expire after 10 minutes) — returns an error indicating the code is no longer valid
- Already-used code (single-use enforcement) — returns rejection if code was already redeemed
- Invalid code format — returns validation error if 'code' is empty or malformed
- Channel already linked — may fail if the current channel is already associated with a different buyer account
- Network or server error — generic 5xx response

## How this service works

Present a link code minted on another channel: merges this channel into that buyer account.

## Output

Returns a JSON object confirming the link was successful, including a boolean 'linked: true', the buyer_id of the account this channel has been merged into, and the channel identifier that was linked.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "code"
 ],
 "properties": {
  "code": {
   "type": "string",
   "minLength": 1
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "linked",
  "buyer_id",
  "channel"
 ],
 "properties": {
  "linked": {
   "type": "boolean",
   "const": true
  },
  "channel": {
   "type": "string"
  },
  "buyer_id": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-withzero-link-code-redemption-79fba4ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from radio.withzero.xyz](https://www.zero.xyz/host/radio.withzero.xyz/llms.txt)