Skip to content

If this moment feels too heavy, you don't have to carry it alone.

AustraliaLifeline 13 11 14 Text 0477 13 11 14Beyond Blue 1300 22 4636Emergency 000
All help lines

On air

Kintsugi Hour

API v1

Responses carry a version header named everlight-version. Send Authorization: Bearer <key> or x-api-key. The machine-readable spec is openapi.json. Everlight Stories integration is on the integration page.

Keys

Publishable keys may run in a browser on an allowed origin. Secret keys stay on a server. Create both in Studio. The full value is shown once, then only a hash is kept. Keys are not part of the production database seed.

On this server, issue a key in Studio and copy it into the partner. There is no shared demo key.

Publishable keys: 60 requests a minute. Secret keys: 120. Dedication submits: 8 every 10 minutes. Responses include x-ratelimit-remaining.

Endpoints

RouteKeyScopeWhat it does
GET /api/v1/stationssecretstations:readStations on this tenant
GET /api/v1/stations/{slug}publishablestations:readBranding, help lines, disclaimer
GET /api/v1/stations/{slug}/now-playingpublishablestations:readShared clock, offset, next item, care banner
GET /api/v1/stations/{slug}/timelinepublishablestations:readItems between from and to
GET /api/v1/stations/{slug}/schedulepublishablestations:readToday's blocks and talks
PUT /api/v1/stations/{slug}/schedulesecretstudio:writeEnable slots and rebuild today
POST /api/v1/stations/{slug}/dedicationspublishablededications:submitSubmit a dedication
GET /api/v1/stations/{slug}/dedicationssecretdedications:moderateModeration queue
PATCH /api/v1/dedications/{id}secretdedications:moderateApprove, reject or flag
GET /api/v1/stations/{slug}/remembrance-wallpublishablestations:readApproved public dedications
GET /api/v1/catalogue/songssecretcatalogue:readCatalogue, including pending rights
GET /api/v1/catalogue/songs/{id}publishablestations:readOne cleared song; secret keys also see pending
GET /api/v1/programmespublishablestations:readTalk programmes
GET /api/v1/programmes/{id}/episodespublishablestations:readEpisodes for a programme
GET /api/v1/help-linespublishablestations:readHelp lines for the key's country
GET /api/v1/stations/{slug}/as-runsecretasrun:readPlay log for a time range

Webhooks

Events include now_playing.changed, dedication.submitted, dedication.approved and dedication.flagged_care. The care event never includes the message, email or moderator notes. Signatures use Everlight-Signature: t=<unix>,v1=<hex> where v1 is HMAC-SHA256 of timestamp.body. Reject signatures older than five minutes. This demo delivers once; Studio can retry. A 24-hour backoff worker is not running.

Embed

The iframe is limited to origins on the station allow-list, plus this app. The care banner stays inside the player. Licensees cannot turn it off.

<iframe src="https://www.pullupradio.fm/embed/everlight" title="Pull Up A Chair Radio player" width="100%" height="460" style="border:0" allow="autoplay"></iframe>
<script src="https://www.pullupradio.fm/embed.js" data-station="everlight" data-origin="https://www.pullupradio.fm"></script>

Try the embed route on its own, or frame it from an allowed page.

Explore everything Everlight

Kintsugi Noki as provider, Pull Up A Chair Radio as the digital channel.

Pull Up A Chair Radio

Programme · Kintsugi Hour

Kintsugi Corner · Episode 2 · Sit with the pieces · Story

Station audio stays mounted while you move around the site.