Releases

Workspace and Atlas release inventory under /v1/workspace/releases and /v1/atlas/releases.

The releases endpoints expose technical catalogue inventory for albums and product editions on Workspace (/v1/workspace/releases) and Atlas (/v1/atlas/releases).

Not catalogue search

Release inventory answers what releases exist in this catalogue plane? Use Catalogue search for MusiSearch track discovery.

Workspace and Atlas

  • Workspace reads: OAuth scope catalog.read. Writes: OAuth scope catalog.write.
  • Atlas reads: OAuth scope atlas.read.
  • No flat /v1/releases path and no entity delete.
  • On detail GET, pass include for expansions; unknown tokens return HTTP 400. List endpoints do not support include.
  • Request the OAuth scopes your integration needs when exchanging client credentials.

Releases and tracks

A release is a product or album container. Tracks are individual recordings listed through /v1/workspace/tracks or /v1/atlas/tracks. Use include=tracks on detail when you need related recordings in one response.

List Workspace releases

curl "https://api.musimap.com/v1/workspace/releases?upc=602566073002" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Filters include outer_id, title, upc, label_id, delivery identifiers, date windows, page, and page_size.

Identifier filters (outer_id, upc, label_id, and similar ids) use exact (normalized) match. title performs a case-insensitive substring match: title=Concerto matches Violin Concerto No. 1. Leading and trailing whitespace is trimmed. Multiple filters combine with logical AND. Pagination applies after filters. A release_date or date window value that is not a real date matches nothing. Unsupported query parameters return HTTP 400.

Get one Workspace release

curl "https://api.musimap.com/v1/workspace/releases/$MUSIMAP_RELEASE_UUID?include=labels,tracks" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path ids are MusiMap release UUIDs. Client/source ids belong in the outer_id list filter.

Atlas releases

Browse and filter Atlas releases directly via /v1/atlas/releases (OAuth scope atlas.read). Use MusiSearch for relevance discovery, then retrieve the selected release from its plane inventory endpoint when needed.

List Atlas releases

curl "https://api.musimap.com/v1/atlas/releases?label_id=$LABEL_UUID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Filter semantics match Workspace: identifiers are exact (normalized); title is a case-insensitive substring match; filters AND; pagination is post-filter; unsupported query parameters return HTTP 400.

Get one Atlas release

curl "https://api.musimap.com/v1/atlas/releases/$MUSIMAP_RELEASE_UUID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"