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