# 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.


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`.


Example

```bash cURL
curl "https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c"
```


```python Python SDK
from aitronos import Aitronos  # pip install aitronos-sdk

# The resolve endpoint is public — no API key needed.
client = Aitronos()

view = client.get("/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c")
if view["available"]:
    print(view["track"]["playback_url"])
else:
    print(view["message"])
```


```python Python
import requests

response = requests.get(
    "https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c"
)
view = response.json()
print(view["kind"], view["available"])
```


```javascript JavaScript
const response = await fetch(
  'https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c'
);

const view = await response.json();
console.log(view.kind, view.available);
```

**Response:**


```json 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
}
```

Errors

```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "This share link is no longer available.",
    "system_message": "Share token invalid, revoked, or expired",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "req_jkl012mno",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```


```json 429 Rate Limit
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again later.",
    "system_message": "Share resolve rate limit exceeded for client IP",
    "type": "rate_limit_error",
    "status": 429,
    "details": {},
    "trace_id": "req_pqr345stu",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

- [Save a shared track](/docs/api-reference/music/save-shared-track)
- [Share a track](/docs/api-reference/music/share-track)
- [Share a collection](/docs/api-reference/music/share-collection)