Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted.
An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"YoLead Developers","description":"Developer documentation for YoLead REST integrations, webhooks, and embedded iframe flows.","colors":{"primary":"#0F766E"},"logo":{"light":"https://mintcdn.com/yolead/DlV_C0EoQy6Sn78H/logo-light.svg?fit=max\u0026auto=format\u0026n=DlV_C0EoQy6Sn78H\u0026q=85\u0026s=4d195c77d9626cba4b994659b670cc0a","dark":"https://mintcdn.com/yolead/DlV_C0EoQy6Sn78H/logo-dark.svg?fit=max\u0026auto=format\u0026n=DlV_C0EoQy6Sn78H\u0026q=85\u0026s=1fbc09fce3afdc3253dcaba5a514b945","href":"/"},"favicon":"https://mintcdn.com/yolead/vPRzPDvxlliB7ABC/favicon.svg?fit=max\u0026auto=format\u0026n=vPRzPDvxlliB7ABC\u0026q=85\u0026s=e1161bed049ae68a506c069d97a1fff7","styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"yolead","hasAudioNarration":false,"actualSubdomain":"yolead","customDomains":["docs.yo-lead.com"],"gitSource":{"type":"github","owner":"maximmuzychenka","repo":"yolead-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac8e25c0c5879b9a30618a7","collectionId":"4f144ed8-8aa2-4169-941c-e0132dc09075","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac8e25c0c5879b9a30618a7"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1922a9f82094bce277340","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"REST API","count":22},{"language":"default","tag":"Integration basics","count":11},{"language":"default","tag":"Contacts","count":9},{"language":"default","tag":"Lists","count":6},{"language":"default","tag":"Embed iframe","count":5},{"language":"default","tag":"Webhooks","count":3},{"language":"default","tag":"Tickets","count":3},{"language":"default","tag":"Start","count":2},{"language":"default","tag":"Resources","count":1},{"language":"default","tag":"Attachments","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/attachments/get-attachment-external-url","slug":"/api-reference/attachments/get-attachment-external-url","pageMetadata":{"title":"Get attachment external URL","description":"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked `accessMode: external`. Opaque IDs from VK provider-history descriptors are not accepted.\n\nAn active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted.\n\nRequired API key scope: `read`.","deprecated":null,"version":null,"sidebarTitle":"Get attachment external url","openapi":"/openapi/public-api-v1.json get /v1/attachments/{attachmentId}/external-url","href":"/api-reference/attachments/get-attachment-external-url","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked \", _jsx(_components.code, {\n children: \"accessMode: external\"\n }), \". Opaque IDs from VK provider-history descriptors are not accepted.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Required API key scope: \", _jsx(_components.code, {\n children: \"read\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get attachment external URL","description":"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked `accessMode: external`. Opaque IDs from VK provider-history descriptors are not accepted.\n\nAn active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted.\n\nRequired API key scope: `read`.","deprecated":null,"version":null,"sidebarTitle":"Get attachment external url","openapi":"/openapi/public-api-v1.json get /v1/attachments/{attachmentId}/external-url","href":"/api-reference/attachments/get-attachment-external-url","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getAttachmentExternalUrl","summary":"Get attachment external URL","description":"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked `accessMode: external`. Opaque IDs from VK provider-history descriptors are not accepted.\n\nAn active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted.\n\nRequired API key scope: `read`.","tags":["Attachments"],"x-yolead-required-scope":"read","x-mint":{"href":"/api-reference/attachments/get-attachment-external-url"},"parameters":["7460b4eb-be18-4e4d-ba5e-1331b8429559"],"responses":{"200":"6b52c71c-a8e7-4659-877d-5f85834a8ae7","400":"3f65bb06-5339-4b90-ae02-4a57525163df","401":"a89d668e-c544-45dc-8097-c53b88cf8f80","403":"ffa1df64-493f-4dbb-9498-c804b3daf641","404":"c568c293-d428-4751-8a46-338bc7a17889","500":"5dc62ca0-4ed7-4b31-b101-97bbc842fddb","503":"44772ac4-d91c-4a2f-b243-c4eb4805a908"},"method":"get","type":"path","servers":["88253d00-ab5f-4dcb-ab12-5686a7c8e1d6"],"security":["c5c74c92-5125-46a9-b078-06aefc3a712a"],"path":"/v1/attachments/{attachmentId}/external-url","baseUrlOptions":["https://api.yo-lead.com"],"title":"Get attachment external URL","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7460b4eb-be18-4e4d-ba5e-1331b8429559":{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"YoLead attachment ObjectId from a standard attachment descriptor.\nMongoDB ObjectId represented as a 24-character hexadecimal string.","example":"64f000000000000000000001","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"YoLead attachment ObjectId from a standard attachment descriptor."}},"responses":{"6b52c71c-a8e7-4659-877d-5f85834a8ae7":{"description":"External viewing URL.","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"External VK video viewing URL.","isRequired":true,"uniqueKey":"data.url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"url":"https://vk.com/video-123_456"}},"examples":{"Example":{"title":"Example","value":{"data":{"url":"https://vk.com/video-123_456"}}}},"exampleType":"examples"}},"exampleType":"examples"},"3f65bb06-5339-4b90-ae02-4a57525163df":{"description":"Validation or business-rule error.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":40001,"message":"Validation error"},"examples":{"Example":{"title":"Example","value":{"code":40001,"message":"Validation error"}}},"exampleType":"examples"}},"exampleType":"examples"},"a89d668e-c544-45dc-8097-c53b88cf8f80":{"description":"Invalid API credentials, stale timestamp, or invalid request signature.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":40121,"message":"Invalid API credentials"},"examples":{"Example":{"title":"Example","value":{"code":40121,"message":"Invalid API credentials"}}},"exampleType":"examples"}},"exampleType":"examples"},"ffa1df64-493f-4dbb-9498-c804b3daf641":{"description":"API key scope is not sufficient for this operation, or the required feature is unavailable on the company's current plan.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficientScope":{"title":"insufficientScope","value":{"code":40361,"message":"API key scope is not sufficient"}},"apiAccessUnavailable":{"title":"apiAccessUnavailable","value":{"code":40351,"message":"API access is unavailable on your current plan"}}},"exampleType":"examples"}},"exampleType":"examples"},"c568c293-d428-4751-8a46-338bc7a17889":{"description":"Attachment not found for the API key company (4041501), or attachment does not support external video viewing (4041502).","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":4041502,"message":"Attachment file is unavailable"},"examples":{"Example":{"title":"Example","value":{"code":4041502,"message":"Attachment file is unavailable"}}},"exampleType":"examples"}},"exampleType":"examples"},"5dc62ca0-4ed7-4b31-b101-97bbc842fddb":{"description":"Unexpected error.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":5001504,"message":"Internal server error"},"examples":{"Example":{"title":"Example","value":{"code":5001504,"message":"Internal server error"}}},"exampleType":"examples"}},"exampleType":"examples"},"44772ac4-d91c-4a2f-b243-c4eb4805a908":{"description":"VK provider access is unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","example":40001,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Validation error","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":5031502,"message":"Attachment provider is unavailable"},"examples":{"Example":{"title":"Example","value":{"code":5031502,"message":"Attachment provider is unavailable"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c5c74c92-5125-46a9-b078-06aefc3a712a":{"YoLeadPublicKey":{"type":"apiKey","in":"header","name":"X-YoLead-Key","description":"Public API key generated in the YoLead UI.","scopes":[],"schemeName":"YoLeadPublicKey"},"YoLeadTimestamp":{"type":"apiKey","in":"header","name":"X-YoLead-Timestamp","description":"Unix timestamp in milliseconds. Requests must be signed within a 5-minute window.","scopes":[],"schemeName":"YoLeadTimestamp"},"YoLeadSignature":{"type":"apiKey","in":"header","name":"X-YoLead-Signature","description":"Hex HMAC-SHA256 signature over `\u003ctimestamp>.\u003craw_body>` using the API secret.","scopes":[],"schemeName":"YoLeadSignature"}}},"servers":{"88253d00-ab5f-4dcb-ab12-5686a7c8e1d6":{"url":"https://api.yo-lead.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-YoLead-Key","description":"Public API key generated in the YoLead UI.","scopes":[],"schemeName":"YoLeadPublicKey"},"schema":{"title":"X-YoLead-Key","type":"string","description":"Public API key generated in the YoLead UI.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"YoLeadPublicKey","name":"X-YoLead-Key"},{"scheme":{"type":"apiKey","in":"header","name":"X-YoLead-Timestamp","description":"Unix timestamp in milliseconds. Requests must be signed within a 5-minute window.","scopes":[],"schemeName":"YoLeadTimestamp"},"schema":{"title":"X-YoLead-Timestamp","type":"string","description":"Unix timestamp in milliseconds. Requests must be signed within a 5-minute window.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"YoLeadTimestamp","name":"X-YoLead-Timestamp"},{"scheme":{"type":"apiKey","in":"header","name":"X-YoLead-Signature","description":"Hex HMAC-SHA256 signature over `\u003ctimestamp>.\u003craw_body>` using the API secret.","scopes":[],"schemeName":"YoLeadSignature"},"schema":{"title":"X-YoLead-Signature","type":"string","description":"Hex HMAC-SHA256 signature over `\u003ctimestamp>.\u003craw_body>` using the API secret.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"YoLeadSignature","name":"X-YoLead-Signature"}],"title":"YoLeadPublicKey \u0026 YoLeadTimestamp \u0026 YoLeadSignature"}]},"originalFileLocation":"openapi/public-api-v1.json"},"subdomain":"yolead","siteName":"YoLead Developers","title":"Get attachment external URL - YoLead Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T06:11:57.682Z","originalFileLocation":"api-reference/attachments/get-attachment-external-url.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted. An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted. Required API key scope: read.\">\u003cmeta data-mint-head name=\"application-name\" content=\"YoLead Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get attachment external URL - YoLead Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted. An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted. Required API key scope: read.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"YoLead Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://yolead.mintlify.app/_mintlify/api/og/v2?division=Attachments\u0026amp;title=Get+attachment+external+URL\u0026amp;description=Returns+an+external+viewing+URL+for+a+stored+VK+video+attachment+belonging+to+the+API+key+company.+Use+a+YoLead+attachment+ObjectId+from+a+standard+descriptor%2C+\u0026amp;theme=49d84bcfb658f6ccc7bb4ccb\u0026amp;signature=eb7e8d52f008022dba03c80fb731dca44e7d1cc6b6606777288b2c04410371ed\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get attachment external URL - YoLead Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted. An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted. Required API key scope: read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yolead.mintlify.app/_mintlify/api/og/v2?division=Attachments\u0026amp;title=Get+attachment+external+URL\u0026amp;description=Returns+an+external+viewing+URL+for+a+stored+VK+video+attachment+belonging+to+the+API+key+company.+Use+a+YoLead+attachment+ObjectId+from+a+standard+descriptor%2C+\u0026amp;theme=49d84bcfb658f6ccc7bb4ccb\u0026amp;signature=eb7e8d52f008022dba03c80fb731dca44e7d1cc6b6606777288b2c04410371ed\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/yolead/0UVy4KCyj2pnON-R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"YoLead Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/attachments/get-attachment-external-url.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.yo-lead.com/#organization\",\"name\":\"YoLead Developers\",\"url\":\"https://docs.yo-lead.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/yolead/DlV_C0EoQy6Sn78H/logo-light.svg?fit=max\u0026auto=format\u0026n=DlV_C0EoQy6Sn78H\u0026q=85\u0026s=4d195c77d9626cba4b994659b670cc0a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.yo-lead.com#website\",\"name\":\"YoLead Developers\",\"url\":\"https://docs.yo-lead.com\",\"publisher\":{\"@id\":\"https://docs.yo-lead.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url#webpage\",\"url\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url\",\"name\":\"Get attachment external URL\",\"description\":\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted. An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted. Required API key scope: read.\",\"dateModified\":\"2026-10-28T06:11:57.682Z\",\"isPartOf\":{\"@id\":\"https://docs.yo-lead.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.yo-lead.com/rest/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get attachment external URL\",\"item\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url#apireference\",\"headline\":\"Get attachment external URL\",\"name\":\"Get attachment external URL\",\"description\":\"Returns an external viewing URL for a stored VK video attachment belonging to the API key company. Use a YoLead attachment ObjectId from a standard descriptor, including descriptors marked accessMode: external. Opaque IDs from VK provider-history descriptors are not accepted. An active VK channel and usable provider access are required. This endpoint returns JSON, not file bytes or a redirect. It does not support other channels or attachment kinds. Do not assume that the returned provider URL remains valid indefinitely. Query parameters are not accepted. Required API key scope: read.\",\"url\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yo-lead.com/api-reference/attachments/get-attachment-external-url#webpage\"},\"dateModified\":\"2026-10-28T06:11:57.682Z\",\"publisher\":{\"@id\":\"https://docs.yo-lead.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.yo-lead.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"YoLead Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"YoLead Developers","nav":{"global":null,"groups":[{"group":"Start","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Integration basics","pages":[{"title":"Chats and tickets","href":"/concepts/chats-and-tickets"},{"title":"Ticket attribution","href":"/concepts/ticket-attribution"},{"title":"Message attachments","href":"/concepts/message-attachments"},{"title":"Telegram Account","href":"/concepts/telegram-account"},{"title":"WhatsApp","href":"/concepts/whatsapp"},{"title":"Avito","href":"/concepts/avito"},{"title":"Instagram","href":"/concepts/instagram"},{"title":"Email channel","href":"/concepts/email-channel"},{"title":"API keys","href":"/api-keys"},{"title":"Authentication","href":"/authentication"},{"title":"Errors","href":"/errors"}]},{"group":"REST API","pages":[{"title":"REST overview","href":"/rest/overview"},{"group":"Employees","pages":[{"title":"List employees","deprecated":null,"version":null,"sidebarTitle":"List employees","openapi":"/openapi/public-api-v1.json get /v1/employees","href":"/api-reference/employees/list-employees"}]},{"group":"Embed","pages":[{"title":"Create embed session","deprecated":null,"version":null,"sidebarTitle":"Create embed session","openapi":"/openapi/public-api-v1.json post /v1/embed/sessions","href":"/api-reference/embed/create-embed-session"}]},{"group":"Tickets","pages":[{"title":"Get ticket history","deprecated":null,"version":null,"sidebarTitle":"Get ticket history","openapi":"/openapi/public-api-v1.json get /v1/tickets/{ticketId}/history","href":"/api-reference/tickets/get-ticket-history"},{"title":"Change ticket status","deprecated":null,"version":null,"sidebarTitle":"Change ticket status","openapi":"/openapi/public-api-v1.json patch /v1/tickets/{ticketId}/status","href":"/api-reference/tickets/change-ticket-status"},{"title":"Change ticket assignee","description":"Changes or removes the assignee of the current active ticket, or assigns the current queued ticket. Required API key scope: `read-write`.\n\nFor an active ticket, set `newAssigneeId` to a different active employee with channel access, or to `null` to remove the assignee and change status to `pending_assignment`. An active ticket must already have an assignee. For a queued ticket, supply an active human employee with channel access; this changes status to `active`. Both operations preserve the ticket and its history. A `new` or `inactive` ticket cannot be changed by this endpoint. Removing the assignee of an already queued ticket is rejected.\n\nThe response always includes `previousAssigneeId`, `newAssigneeId`, and `status`; assignee IDs can be `null`. Queue transitions emit both `ticket.assignee_changed` and `ticket.status_changed`.","deprecated":null,"version":null,"sidebarTitle":"Change ticket assignee","openapi":"/openapi/public-api-v1.json patch /v1/tickets/{ticketId}/assignee","href":"/api-reference/tickets/change-ticket-assignee"}]},{"group":"Attachments","pages":[{"title":"Get attachment external URL","deprecated":null,"version":null,"sidebarTitle":"Get attachment external url","openapi":"/openapi/public-api-v1.json get /v1/attachments/{attachmentId}/external-url","href":"/api-reference/attachments/get-attachment-external-url"}]},{"group":"Contacts","pages":[{"title":"List contacts","description":"Returns active contacts for the API key company, newest first. Use `search` to filter results. Required API key scope: `read`.","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /v1/contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Create contact","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/contacts","href":"/api-reference/contacts/create-contact"},{"title":"Create contacts in bulk","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/contacts/bulk","href":"/api-reference/contacts/create-contacts-in-bulk"},{"title":"Delete contacts in bulk","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/contacts/bulk-delete","href":"/api-reference/contacts/delete-contacts-in-bulk"},{"title":"Merge contacts","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/contacts/{sourceContactId}/merge","href":"/api-reference/contacts/merge-contacts"},{"title":"Update contact","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json patch /v1/contacts/{contactId}","href":"/api-reference/contacts/update-contact"},{"title":"Delete contact","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json delete /v1/contacts/{contactId}","href":"/api-reference/contacts/delete-contact"},{"title":"Add contact to list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/contacts/{contactId}/lists","href":"/api-reference/contacts/add-contact-to-list"},{"title":"Remove contact from list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json delete /v1/contacts/{contactId}/lists/{listId}","href":"/api-reference/contacts/remove-contact-from-list"}]},{"group":"Lists","pages":[{"title":"List contact lists","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /v1/lists","href":"/api-reference/lists/list-contact-lists"},{"title":"Create contact list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/lists","href":"/api-reference/lists/create-contact-list"},{"title":"Get contact list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /v1/lists/{listId}","href":"/api-reference/lists/get-contact-list"},{"title":"Update contact list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json patch /v1/lists/{listId}","href":"/api-reference/lists/update-contact-list"},{"title":"Delete contact list","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json delete /v1/lists/{listId}","href":"/api-reference/lists/delete-contact-list"},{"title":"Add contacts to list in bulk","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /v1/lists/{listId}/contacts","href":"/api-reference/lists/add-contacts-to-list-in-bulk"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks overview","href":"/webhooks/overview"},{"title":"Verifying signatures","href":"/webhooks/verifying-signatures"},{"title":"Events","href":"/webhooks/events"}]},{"group":"Embed iframe","pages":[{"title":"Embed overview","href":"/embed/overview"},{"title":"Create a session","href":"/embed/create-session"},{"title":"Capabilities","href":"/embed/capabilities"},{"title":"Examples","href":"/embed/examples"},{"title":"Iframe events","href":"/embed/events"}]},{"group":"Resources","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Get attachment external URL - YoLead Developers","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}