{"uid":"cap_gePb_zPabXiu_EZOXZbVV","slug":"radio-withzero-xyz-add-program-to-station-library-523f4fe4","name":"Add Program to Station Library","description":"Add a program to your station library (free for the owner). Your library is the rotation that fills unsold airtime; tips on those airings are yours.","url":"https://radio.withzero.xyz/api/v1/stations/{id}/programs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["title","audioUrl","rightsAttested"],"properties":{"title":{"type":"string","maxLength":120,"minLength":1,"description":"Program title."},"audioUrl":{"type":"string","format":"uri","description":"Publicly fetchable URL of the audio (mp3/m4a/wav/ogg/flac)."},"coverUrl":{"type":"string","format":"uri","description":"Optional cover image (png/jpg/webp, max 5 MB)."},"rightsAttested":{"type":"boolean","description":"Must be true: you attest you hold the rights to broadcast this audio."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["programId","title","station","durationSec"],"properties":{"title":{"type":"string"},"station":{"type":"string"},"programId":{"type":"string"},"durationSec":{"type":"number"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"radio.withzero.xyz","brandSlug":"radio-withzero-xyz-mpp","brandBaseUrl":"https://radio.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Adds a pre-recorded audio program to a radio station owner's library so it can fill unsold airtime slots and earn listener tips.","exampleAgentPrompt":"Add my show 'Morning Bloom Coffee Hour' to my station library — the audio is at https://cdn.example.com/morning-bloom-ep1.mp3 and I confirm I hold the broadcast rights.","exampleUseCases":[{"title":"Podcast episode added to rotation","prompt":"Add my new podcast episode called 'The Deep Dive: Episode 12' to my station library — the mp3 is at https://podcasts.example.com/deepdive-ep12.mp3 and I attest I own the rights."},{"title":"DJ mix uploaded for passive airplay","prompt":"Upload my DJ mix 'Summer Vibes 2024' to my station's program library using this audio file: https://mixes.example.com/summer-vibes-2024.mp3 — I hold all the rights to broadcast it."},{"title":"Talk show added with cover art","prompt":"Add my talk show 'Tech Futures Weekly' to my station library with the audio at https://shows.example.com/tech-futures-ep5.mp3 and cover image at https://shows.example.com/cover.jpg — I confirm I have broadcast rights."}],"resultDescription":"Returns the newly created program's ID, title, associated station name, and duration in seconds — confirming the program has been added to the station library and is eligible to fill unsold airtime slots.","failureModes":["Missing or invalid audio URL returns 400 Bad Request","rightsAttested set to false or missing causes rejection","Audio file at provided URL is not publicly accessible, causing fetch failure","Invalid station ID in path returns 404 Not Found","Audio format not supported (non-mp3/m4a/wav/ogg/flac) may cause processing error","Title exceeds 120 characters returns validation error","Unauthorized station ownership returns 403 Forbidden"],"whenToPreferThis":"Use this endpoint when a station owner wants to build up a library of pre-recorded content that automatically fills unsold airtime slots and passively earns tips — as opposed to buying immediate live airtime (which schedules a one-time broadcast). This is the right endpoint for building a passive content rotation, not for scheduling a specific broadcast time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-30T19:38:25.280Z","lastSuccessfullyRanAt":"2026-07-30T19:38:25.280Z","lastHealthCheckAt":"2026-10-11T00:30:36.048Z","isFirstParty":true,"canonicalSlug":"radio-withzero-xyz-add-program-to-station-library-523f4fe4"}