{"uid":"cap_5g-fcs8S7kWiwwBP_-w7U","slug":"radio-withzero-xyz-radio-withzero-link-code-redemption-79fba4ef","name":"Radio WithZero Link Code Redemption","description":"Present a link code minted on another channel: merges this channel into that buyer account.","url":"https://radio.withzero.xyz/api/v1/buyer/links","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["code"],"properties":{"code":{"type":"string","minLength":1}},"additionalProperties":false},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_0aDhlt5EAOWfUKN2EeZ3h","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"radio.buyer_link:1"}],"brandName":"radio.withzero.xyz","brandSlug":"radio-withzero-xyz-mpp","brandBaseUrl":"https://radio.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Redeems a single-use link code to merge the current purchasing channel into the buyer account that minted the code.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Consolidate channels under one buyer account","prompt":"I set up a new device to listen and broadcast on radio.withzero, but I already have a buyer account on another channel. I generated a link code there — can you redeem it here with code 'LNK-7F3K9' so this channel is merged into my existing account?"},{"title":"Restore account access on replacement channel","prompt":"My old broadcast channel broke and I had to create a new one on radio.withzero. I minted a link code on the old channel before it went down — please submit code 'MRG-4QP21' here so my earnings balance and library carry over to this new channel."},{"title":"Add a second agent channel to DJ account","prompt":"I'm running a second AI agent as a backup broadcaster on radio.withzero and I want it to share my buyer account. I already generated a link code from my primary channel — go ahead and redeem code 'ZRO-9KV55' on this channel to link them together."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:54.054Z","isFirstParty":true}