Skip to content
/
Open a shared link
Last updated

Open a shared link

Resolve a share token into a read-only view of the shared track or collection, with freshly-minted signed playback URLs and truthful licence information.

Note: This is the only Music Studio endpoint that does not require authentication — it is a public resolve. It is rate-limited and audited per client IP. Do not send an API key.

GEThttps://api.aitronos.com/v1/music/shared/{token}

A missing, revoked, expired, or over-limit link returns a graceful error — never a stack trace. If the creator removed the underlying content, the response carries available: false with a human-readable message instead of track data.

Path parameters

token string required

The raw share token from the share url.

Returns

A resolved share view.

kind string · track or collection.

available boolean · false when the creator removed the content — the body then carries only message.

message string · Human-readable explanation when content is unavailable, otherwise null.

share object · Public share metadata: target_type, visibility, expires_at.

track object · The shared track (for a track share), otherwise null. See the track view fields below.

collection object · The shared collection's id, name, and description (for a collection share), otherwise null.

tracks array · The collection's track views (for a collection share), otherwise null.

Each track view contains:

  • id string · Track id (mtrack_-prefixed).
  • title string · Track title.
  • engine string · Internal engine key the track was generated with.
  • mode string · Generation mode.
  • measured_duration_seconds number · Measured duration in seconds.
  • instrumental boolean · Whether the track is instrumental.
  • playback_url string · Short-TTL signed URL for the audio.
  • licence object · Truthful licence facts: licence_class, licence_version, commercial_use (never overstated), requires_attribution.
cURL
curl "https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c"

Response:

200 OK
{
  "kind": "track",
  "available": true,
  "message": null,
  "share": {
    "target_type": "track",
    "visibility": "link_only",
    "expires_at": "2026-07-28T10:30:00Z"
  },
  "track": {
    "id": "mtrack_b4d9e1c6a72f",
    "title": "Late Night Study",
    "engine": "studio",
    "mode": "creation",
    "measured_duration_seconds": 120.4,
    "instrumental": true,
    "playback_url": "https://cdn.aitronos.com/music/track/...signed",
    "licence": {
      "licence_class": "personal_only",
      "licence_version": "2026-01",
      "commercial_use": false,
      "requires_attribution": false
    }
  },
  "collection": null,
  "tracks": null
}
Previous page
Next page