# Add Program to Station Library

> Add Program to Station Library is a free API for AI agents from radio.withzero.xyz, Free, status unknown (last checked 2026-10-11, last successful call 2026-07-30).

Adds a pre-recorded audio program to a radio station owner's library so it can fill unsold airtime slots and earn listener tips.

## Facts

- Endpoint: POST https://radio.withzero.xyz/api/v1/stations/{id}/programs?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-07-30
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 3
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-add-program-to-station-library-523f4fe4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gePb_zPabXiu_EZOXZbVV

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-add-program-to-station-library-523f4fe4 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-add-program-to-station-library-523f4fe4/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)