{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","tabs","tab","code-group"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Open a shared link","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"open-a-shared-link","__idx":0},"children":["Open a shared link"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," This is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET","path":"https://api.aitronos.com/v1/music/shared/{token}"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available: false"]}," with a human-readable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," instead of track data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"path-parameters","__idx":1},"children":["Path parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The raw share token from the share ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":2},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A resolved share view."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind"]}]}," string · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["track"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["collection"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available"]}]}," boolean · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," when the creator removed the content — the body then carries only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]}," string · Human-readable explanation when content is unavailable, otherwise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["share"]}]}," object · Public share metadata: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target_type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["visibility"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["track"]}]}," object · The shared track (for a track share), otherwise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},". See the track view fields below."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["collection"]}]}," object · The shared collection's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," (for a collection share), otherwise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracks"]}]}," array · The collection's track views (for a collection share), otherwise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each track view contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]}," string · Track id (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mtrack_"]},"-prefixed)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]}," string · Track title."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["engine"]}]}," string · Internal engine key the track was generated with."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]}," string · Generation mode."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["measured_duration_seconds"]}]}," number · Measured duration in seconds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instrumental"]}]}," boolean · Whether the track is instrumental."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["playback_url"]}]}," string · Short-TTL signed URL for the audio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["licence"]}]}," object · Truthful licence facts: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["licence_class"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["licence_version"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commercial_use"]}," (never overstated), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requires_attribution"]},"."]}]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Example","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl \"https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python SDK","header":{"title":"Python SDK","controls":{"copy":{}}},"source":"from aitronos import Aitronos  # pip install aitronos-sdk\n\n# The resolve endpoint is public — no API key needed.\nclient = Aitronos()\n\nview = client.get(\"/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c\")\nif view[\"available\"]:\n    print(view[\"track\"][\"playback_url\"])\nelse:\n    print(view[\"message\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import requests\n\nresponse = requests.get(\n    \"https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c\"\n)\nview = response.json()\nprint(view[\"kind\"], view[\"available\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const response = await fetch(\n  'https://api.aitronos.com/v1/music/shared/shr_9f3a2b7c1e4d6a8f0b2c4d6e8f1a3b5c'\n);\n\nconst view = await response.json();\nconsole.log(view.kind, view.available);\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"200 OK","header":{"title":"200 OK","controls":{"copy":{}}},"source":"{\n  \"kind\": \"track\",\n  \"available\": true,\n  \"message\": null,\n  \"share\": {\n    \"target_type\": \"track\",\n    \"visibility\": \"link_only\",\n    \"expires_at\": \"2026-07-28T10:30:00Z\"\n  },\n  \"track\": {\n    \"id\": \"mtrack_b4d9e1c6a72f\",\n    \"title\": \"Late Night Study\",\n    \"engine\": \"studio\",\n    \"mode\": \"creation\",\n    \"measured_duration_seconds\": 120.4,\n    \"instrumental\": true,\n    \"playback_url\": \"https://cdn.aitronos.com/music/track/...signed\",\n    \"licence\": {\n      \"licence_class\": \"personal_only\",\n      \"licence_version\": \"2026-01\",\n      \"commercial_use\": false,\n      \"requires_attribution\": false\n    }\n  },\n  \"collection\": null,\n  \"tracks\": null\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Errors","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"404 Not Found","header":{"title":"404 Not Found","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"RESOURCE_NOT_FOUND\",\n    \"message\": \"This share link is no longer available.\",\n    \"system_message\": \"Share token invalid, revoked, or expired\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {},\n    \"trace_id\": \"req_jkl012mno\",\n    \"timestamp\": \"2026-06-28T10:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"429 Rate Limit","header":{"title":"429 Rate Limit","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"RATE_LIMIT_EXCEEDED\",\n    \"message\": \"Too many requests. Please try again later.\",\n    \"system_message\": \"Share resolve rate limit exceeded for client IP\",\n    \"type\": \"rate_limit_error\",\n    \"status\": 429,\n    \"details\": {},\n    \"trace_id\": \"req_pqr345stu\",\n    \"timestamp\": \"2026-06-28T10:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":3},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/save-shared-track"},"children":["Save a shared track"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/share-track"},"children":["Share a track"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/share-collection"},"children":["Share a collection"]}]}]}]},"headings":[{"value":"Open a shared link","id":"open-a-shared-link","depth":1},{"value":"Path parameters","id":"path-parameters","depth":2},{"value":"Returns","id":"returns","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Open a shared link","keywords":["resolve share","open shared track","public music link","shared collection"],"seo":{"title":"Open a shared link"}},"lastModified":"2026-06-28T21:42:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/music/resolve-share","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}