Changelog
Track the latest changes, improvements, and updates to the limbo/API
AI content declaration
LatestNovember 17, 2026
Releases can now declare how much generative AI was used to make them.
Albums expose ai-artwork (the cover art) and
tracks expose ai-recording and ai-video
(the video, on music videos). Each one takes none, partial or full.
Core credits on track-artists
and extended credits on tracks carry an ai-used boolean.
They are all optional and default to none / false. Omitting them on an update leaves
them unchanged. Any other value, null included, is answered with a 422.
Album store links
November 16, 2026
The new
GET /albums/{id}/store-links
endpoint returns the links where an album is available on Spotify and Apple. Each item has
dsp and url; the list is empty
when no link is known yet.
Spotify Videos
October 27, 2026
Music videos can now be released on the Spotify Videos DSP. Music video
tracks
expose three new optional attributes: video-content-type
(official, performance_live or
performance_cover), related-audio-isrc
(the ISRC of the audio recording an official video belongs to) and video-thumbnail
(a 16:9 JPEG or PNG, at least 1920x1080, up to 15 MB). The new
POST /related-audio-check
endpoint tells you which recording an ISRC names before you save it. The Spotify Videos DSP takes a release
of exactly one music video (see album-dsps),
and GET /albums/{id}/validate and
POST /distribution-requests
list what is still missing, each message ending with its error code.
YouTube channel on an artist
October 20, 2026
Artists can now be linked to their YouTube channel through
artist-dsp-availabilities,
using the YouTube DSP (3). Send the channel ID, the channel's
@handle or its URL in external-artist-id:
the channel is checked on YouTube before it is saved, and the resource returns its channel ID, its URL and
its title in the new read-only external-artist-name attribute.
Fingerprint scan per track
October 19, 2026
Tracks now expose the new
allow-fingerprint-scan
attribute, the same "Allow fingerprint scan" option available in the dashboard. Send
false on POST /tracks or
PATCH /tracks/{id} to keep a track out of fingerprint DSPs
(YouTube Content ID, Meta and TikTok) while the rest of the release is still delivered to them.
It is optional and defaults to true; omitting it on an update leaves it
unchanged. It cannot be false on a music video.
Dolby Atmos and music video masters
October 15, 2026
Tracks can now carry a Dolby Atmos master and a music video master. Attach one by URL with
POST /track-assets:
the file is validated when it is attached, and
GET /track-assets/{id} shows its validation-status.
A track holds one asset of each type; to replace a master, delete it and attach the new one.
- • Music videos: the new
is-videoattribute turns a track into a music video. - • Video releases: albums with the
Videoformat follow their own rules, and need the video feature on your account. - • Distribution: while a video master of the release is not ready yet, the album shows
qa-statusawaiting_conversion(details).
Brand-new Spotify artists (NEW)
October 12, 2026
An artist with no Spotify profile yet can now be marked as brand-new: send
"external-artist-id": "NEW" for Spotify on
POST /artist-dsp-availabilities
or PATCH /artist-dsp-availabilities/{id}. No URL is needed; it is stored as
null. It is accepted only for an artist with no Spotify profile linked that
does not appear on a release already sent, and NEW is replaced with the real
Spotify ID once it is available.
Extended track credits
October 12, 2026
Tracks now accept instrument and additional role credits beyond the core artist roles: send them in the new
extended-credits
attribute on POST /tracks and PATCH /tracks/{id}.
GET /credit-roles
lists every role and instrument you can use, roles first and then instruments, each by name, and
GET /track-credits
reads the credits back, filtered by track, album, artist or role.
Webhooks
October 5, 2026
Webhooks are now available: register
an HTTPS URL with POST /webhook-endpoints, choose the event types you want,
and receive one signed POST per event: an album changing status, a
distribution request moving forward, a delivery being created, what happened to a delivery at the store (sent,
completed, rejected, failed or skipped), and an analytics report finishing.
Royalties: your statement
October 1, 2026
GET /royalties/summary
and GET /royalties/payments
are now documented: they return the current royalty position, its period-by-period history and the payment
history of the authenticated user, with no identifier to send. Both accept an optional period range,
filter[period-from] and filter[period-to]
(YYYY-MM, inclusive); on the summary it narrows the history, never the current balance.
Artists: same-name artists
September 28, 2026
POST /artists
accepts meta.allow-duplicate-name: send true to create
a new artist even when your user already has one with that name. Without it, the existing artist is returned, as before.
Users resource
July 30, 2026
/users
is now available: list, create and update the users of your organization, assign roles and manage their DSP
access.
Amazon Music & TikTok analytics reports
July 5, 2026
Daily analytics report downloads now cover Amazon Music and TikTok, in addition to Spotify, YouTube and Apple Music.
Amazon Music · dsp_id 6
Streams, offline plays, play duration, and country, device, source, quality and subscription-plan breakdowns.
TikTok · dsp_id 9
Views, watch time, video creations, engagement (likes, comments, shares, favourites), and top-country breakdown.
Affected resources
| Resource | What's new |
|---|---|
| analytics-reports | Amazon Music (dsp_id 6) and TikTok (dsp_id 9) are now valid DSPs for report generation |
Multi-disc support
July 3, 2026
Albums can now be organized across multiple discs. Tracks can be assigned to a disc, and each disc keeps its own track numbering.
New Features
- • Assign each track to a disc within an album
- • Filter album tracks by disc
- • Sort album tracks by disc
Improvements
- • Each disc has its own independent track numbering
- • Album tracks are returned grouped and ordered by disc
Affected resources
| Resource | What's new |
|---|---|
| album-tracks | A disc can be assigned to each track; tracks can be filtered and sorted by disc, with independent numbering per disc |
| tracks | Album track listings are returned in disc and track order |