# Inline Share | AudioDN Docs

> Public, no-auth redirect URLs for sharing a single track variant on social media.

Source: https://audiodeliverynetwork.com/docs/api/share/

---

# Inline Share

Inline Share Keys let you attach a key to a URL that anyone can open — no Authorization header, no play session handshake. Each request validates the key, signs a short-lived CDN URL for the key's variant, and returns a `302` redirect to the audio file.

#### High usage

Share links are public. Anyone with the URL can stream until the key expires or is deleted. Each request counts toward play usage and billing. Set an expiry date when possible and delete keys you no longer need.

## Creating a Share Key

In the [AudioDN dashboard](https://account.audiodeliverynetwork.com), go to **Settings → API Keys** and create an **Inline Share Key**. You must select exactly one variant. Optionally limit the key to a collection or track.

## Share URL Format

Append your Inline Share Key to the stream endpoint for the track you want to share:

```
https://api.audiodelivery.net/v1/stream/{track_id}/{share_key}
```

The organization ID is encoded in the key prefix — you do not need to include it in the path.

GET `/v1/stream/:track_id/:api_key`

Validates an Inline Share Key and redirects to a signed CDN URL for the key's variant

#### Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `track_id` | uuid | Required | ID of the track to stream (path parameter) |
| `api_key` | string | Required | Inline Share Key including org prefix (path parameter) |

#### Response

```
HTTP/1.1 302 Found
Location: https://{org_domain}/{file_path}?verify={hmac_token}
Cache-Control: no-store
```

No JSON body is returned. The client follows the redirect to stream audio from your organization's CDN domain. The signed URL is valid for one hour; request the share URL again to mint a fresh token.

## Key Scope

-   **Org-wide** — any track in your organization (default)
-   **Collection** — only tracks in the specified collection
-   **Track** — only the specified track (when collection is also set)

The key's single variant is always enforced. Requests for tracks outside the key's scope return `404`.