Works

Workspace work inventory with GET /v1/workspace/works (read-only).

The works endpoints expose technical catalogue inventory for musical compositions in organisation Workspace catalogues under /v1/workspace/works. Works are read-only on the public API. There is no Atlas works plane and no entity delete.

Works vs tracks

A work is the composition (title, ISWC when available). A track is a specific recording (ISRC, audio assets).

Scope and access

  • GET /v1/workspace/works and GET /v1/workspace/works/{work_id}.
  • OAuth scope: catalog.read.
  • Path ids are MusiMap work UUIDs. Client ids belong in outer_id filters.
  • On detail GET, pass include for expansions; unknown tokens return HTTP 400. List endpoints do not support include.
  • There is no /v1/atlas/works route.
  • Request the OAuth scopes your integration needs when exchanging client credentials.

List Workspace works

curl "https://api.musimap.com/v1/workspace/works?iswc=T-010.171.157-7" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Supported list filters include outer_id, title, iswc, delivery identifiers, date windows, page, and page_size.

Identifier filters (outer_id, iswc, and similar ids) use exact (normalized) match. title performs a case-insensitive substring match: title=Together matches Come Together. Leading and trailing whitespace is trimmed. Multiple filters combine with logical AND. Pagination applies after filters. Unsupported query parameters return HTTP 400.

Get one Workspace work

curl "https://api.musimap.com/v1/workspace/works/$MUSIMAP_WORK_UUID?include=details,artists" \
  -H "Authorization: Bearer $ACCESS_TOKEN"