Skip to main content
POST
One recording: the name a recognizer gave it, where to hear it away from Dally, its cover art while a person is looking at it, how many reels the caller can read carry it, what those reels usually get, and their cards. Every reel carrying the recording is gathered, whoever made it, however the fold grouped its windows. A reel the caller cannot read is absent from the cards and absent from the count. The frame asks for it when a person opens the bed; a card never carries it.

Authorizations

Authorization
string
header
required

A WorkOS-dashboard-issued internal API key on Authorization: Bearer.

Body

application/json
bed
string
required

The recording's key, the one id a bed is served under: isrc: when the recognizer returned an ISRC, else shazam: when it returned its own key for the track, else window: for a bed no recognizer has identified beyond this fold. Every reel carrying the same recording carries the same key, so opening it from any card reaches the same bed.

Minimum string length: 1

Response

Success. request_id is present on every response.

bed
string
required

The recording's key, the one id a bed is served under: isrc: when the recognizer returned an ISRC, else shazam: when it returned its own key for the track, else window: for a bed no recognizer has identified beyond this fold. Every reel carrying the same recording carries the same key, so opening it from any card reaches the same bed.

Minimum string length: 1
title
string
required

The recording's title, as the recognizer returned it.

Minimum string length: 1
artist
string | null
required

The recording's artist, as the recognizer returned it; null when the answer carried none.

isrc
string | null
required

The recording's ISRC, as the recognizer returned it; null when the answer carried none.

apple_music_url
string | null
required

Apple Music's own page for this recording, taken verbatim from the recognizer's answer; null unless that answer carried a real https://music.apple.com link, which about two thirds of them do.

shazam_url
string | null
required

The recognizer's own page for this recording, taken verbatim from its answer; null when the answer carried none.

cover_art_url
string | null
required

Apple's own URL for this recording's album art, looked up from Apple while this answer was being written and never held by Dally, so the picture is loaded from Apple's servers by whoever is looking at it. Null unless this bed carries an apple_music_url the art can sit beside, and null whenever the lookup missed, timed out or answered anything but a picture; the bed reads the same either way.

reels
integer
required

How many reels the caller can read carry this recording, counting every one of them, not only the ones whose cards ride in members.

Required range: x >= 0
median_views
number | null
required

The middle view count of those reels; null when none of them carries a view count.

Required range: x >= 0
members
object[]
required

Those reels' cards, most-viewed first, in the same shape a card read hands back, capped at one page. A reel the caller cannot read is absent here and absent from reels.

request_id
string
required

Server-minted id for this request. Present on every response, success and error — quote it when reporting a problem.

Minimum string length: 1