{"openapi":"3.0.3","info":{"title":"Pull Up A Chair Radio API","version":"1.0.0","description":"Versioned API for Pull Up A Chair Radio stations. Publishable keys (pk_test_ or pk_live_) are safe in a browser. Secret keys (sk_test_ or sk_live_) stay on a server. The help banner and care disclaimer are always returned and cannot be switched off."},"servers":[{"url":"https://www.pullupradio.fm/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/stations":{"get":{"summary":"List the tenant's stations","description":"Requires a secret key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}":{"get":{"summary":"Branding, time zone, help lines and embed settings","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/now-playing":{"get":{"summary":"Shared-clock item, the listener's help lines, and the open ad break if the clock is inside one","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/timeline":{"get":{"summary":"Items between from and to, for preloading","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/schedule":{"get":{"summary":"Human schedule for a date in the station's time zone","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}},"put":{"summary":"Update schedule slots and rebuild the day","description":"Requires a secret key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/dedications":{"get":{"summary":"Moderation queue","description":"Requires a secret key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}},"post":{"summary":"Submit a dedication. Consent and 18+ confirmation are required.","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/remembrance-wall":{"get":{"summary":"Approved dedications with display consent","description":"Publishable key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/stations/{slug}/as-run":{"get":{"summary":"Play log for a time range","description":"Requires a secret key.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/dedications/{id}":{"patch":{"summary":"Approve, edit, reject, flag for care, schedule or mark aired","description":"Requires a secret key.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/catalogue/songs":{"get":{"summary":"Catalogue the tenant is licensed for","description":"Requires a secret key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/catalogue/songs/{id}":{"get":{"summary":"Public metadata for a cleared song","description":"Publishable key.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/programmes":{"get":{"summary":"Talk programmes","description":"Publishable key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/programmes/{id}/episodes":{"get":{"summary":"Episodes for a programme","description":"Publishable key.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/help-lines":{"get":{"summary":"Verified crisis lines for country. Unknown countries return findahelpline.com and no invented number.","description":"Publishable key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/ads/decision":{"get":{"summary":"Creative for this listener's break. Query: station, break, breaks_heard. Direct city, region, country, then global, then house.","description":"Publishable key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/uploads":{"post":{"summary":"Upload an MP3. Returns duration_ms and loudness_lufs.","description":"Requires a secret key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/songs":{"post":{"summary":"Create song metadata after upload. Rights status starts at pending.","description":"Requires a secret key.","parameters":[],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid key"},"403":{"description":"Scope, origin or key type"}}}},"/openapi.json":{"get":{"summary":"This document","security":[]}}},"webhooks":{"dedication.approved":{"post":{"summary":"Signed HTTPS POST. Header Everlight-Signature: t=<unix>,v1=<hmac sha256 of timestamp.body>"}},"dedication.flagged_care":{"post":{"summary":"No message text. Only an id and a studio path."}},"now_playing.changed":{"post":{"summary":"Fires when the on-air item changes."}}}}