--- updatedAt: 2026-09-10T15:50:00.000Z agentTools: projectIndex: https://docs.synthesia.io/llms.txt --- # Get user media asset Retrieves a user uploaded media asset by its ID. Returns the asset's status, title, content type, and metadata including detected language if available. Currently only supports user-uploaded assets in the dubbing configuration. # OpenAPI definition ```json { "info": { "description": "Synthesia public API endpoints", "title": "Synthesia API", "version": "2.0.0" }, "servers": [ { "url": "https://api.synthesia.io", "description": "Synthesia public API URL." } ], "paths": { "/v2/assets/{user_media_asset_id}": { "get": { "summary": "Get user media asset", "description": "Retrieves a user uploaded media asset by its ID. Returns the asset's status, title, content type, and metadata including detected language if available. Currently only supports user-uploaded assets in the dubbing configuration.", "tags": [ "Assets" ], "security": [ { "api_key": [] } ], "parameters": [ { "in": "path", "name": "user_media_asset_id", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "The unique identifier of the media asset to retrieve." } ], "responses": { "200": { "description": "Success. Returns the media asset details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPublicApiUserUploadedAssetResponse" } } } }, "400": { "description": "Bad Request. Asset is not a valid user uploaded asset.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not Found. Asset does not exist or user does not have access.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "Unexpected Server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "openapi": "3.0.2", "components": { "schemas": { "AssetContentType": { "description": "AssetContentType specifies the MIME type of a particular asset, and provides some helper methods and properties", "enum": [ "image/webp", "image/jpeg", "image/png", "image/svg+xml", "image/gif", "video/mp4", "video/webm", "video/quicktime", "audio/wav", "audio/mpeg", "audio/ogg", "audio/aac", "audio/flac", "audio/mp4", "audio/webm", "font/otf", "font/ttf", "font/woff", "application/font-woff", "font/woff2", "application/vnd.ms-powerpoint", "application/vnd.openxmlformats-officedocument.presentationml.presentation", "application/vnd.synthesia.studio-video", "application/vnd.synthesia.studio-imported-video", "application/vnd.synthesia.studio-dubbed-video", "application/vnd.synthesia.studio-photo-avatar-video", "application/vnd.synthesia.studio-synthesia-academy-video", "application/vnd.synthesia.studio-synthesia-feature-overview-video", "application/vnd.synthesia.studio-synthesia-example-video", "application/vnd.synthesia.studio-synthesia-demo-video", "application/vnd.synthesia.studio-synthesia-welcome-webinar-video", "application/vnd.synthesia.studio-user-template", "application/vnd.synthesia.studio-synthesia-template", "application/vnd.synthesia.studio-synthesia-processed-gif", "application/vnd.synthesia.studio-user-course", "application/vnd.synthesia.font-family", "application/vnd.synthesia.folder", "application/json", "application/x-xliff+xml", "application/pdf", "text/csv" ], "title": "AssetContentType", "type": "string" }, "GetPublicApiMediaAssetMetadataResponse": { "properties": { "detectedLanguage": { "default": null, "allOf": [ { "$ref": "#/components/schemas/LanguageBCP47" } ], "nullable": true } }, "title": "GetPublicApiMediaAssetMetadataResponse", "type": "object" }, "LanguageBCP47": { "description": "A class for representing languages according to the BCP-47 standard.\nThe standard is followed very loosely, only primary language and region\nsub-tags are implemented right now.\n\nThe display names of the languages are derived from the enum names,\nwith the primary language name capitalized and the region name\ncapitalized and enclosed in parentheses if present. If you need to\ncustomize the display name for a specific language, you can override\nthe `override_display_name` method.\n\nhttps://www.w3.org/International/questions/qa-choosing-language-tags", "enum": [ "af", "sq", "am", "ar", "ar-DZ", "ar-BH", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LY", "ar-MA", "ar-QA", "ar-SA", "ar-SY", "ar-TN", "ar-AE", "ar-YE", "hy", "as", "az", "ba", "eu", "be", "bn", "bs", "br", "bg", "my", "ca", "zh", "zh-CN", "zh-HK", "zh-TW", "hr", "cs", "da", "nl", "nl-BE", "nl-NL", "en", "en-AU", "en-CA", "en-GB", "en-HK", "en-IN", "en-IE", "en-KE", "en-MX", "en-NZ", "en-NG", "en-PH", "en-SG", "en-ZA", "en-TZ", "en-US", "et", "fo", "fil", "fi", "fr", "fr-BE", "fr-CA", "fr-FR", "fr-CH", "gl", "ka", "de", "de-AT", "de-DE", "de-CH", "el", "gu", "ht", "ha", "haw", "he", "hi", "hu", "is", "id", "ga", "it", "ja", "jw", "kn", "kk", "km", "ko", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "mt", "mi", "mr", "mn", "ne", "no", "nb", "nn", "oc", "or", "pa", "ps", "fa", "pl", "pt", "pt-BR", "pt-PT", "ro", "ru", "sa", "sr", "sn", "sd", "si", "sk", "sl", "so", "es", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-CU", "es-DO", "es-EC", "es-SV", "es-GQ", "es-GT", "es-HN", "es-LA", "es-MX", "es-NI", "es-PA", "es-PY", "es-PE", "es-PR", "es-ES", "es-US", "es-UY", "es-VE", "su", "sw", "sv", "tl", "tg", "ta", "ta-IN", "ta-SG", "ta-LK", "tt", "te", "th", "bo", "tr", "tk", "uk", "ur", "uz", "vi", "cy", "yi", "yo", "zu", "und" ], "title": "LanguageBCP47", "type": "string" }, "PublicApiUserUploadedAssetErrorCodes": { "enum": [ "asset_upload", "language_detect", "unknown" ], "title": "PublicApiUserUploadedAssetErrorCodes", "type": "string" }, "PublicApiUserUploadedAssetStatus": { "enum": [ "awaiting_upload", "processing", "error", "ready" ], "title": "PublicApiUserUploadedAssetStatus", "type": "string" }, "GetPublicApiUserUploadedAssetResponse": { "properties": { "id": { "title": "Id", "type": "string" }, "title": { "description": "The title of the user uploaded asset.", "title": "Title", "type": "string" }, "contentType": { "$ref": "#/components/schemas/AssetContentType", "description": "The content type of the user uploaded asset." }, "status": { "$ref": "#/components/schemas/PublicApiUserUploadedAssetStatus", "description": "The status of the user uploaded asset." }, "metadata": { "$ref": "#/components/schemas/GetPublicApiMediaAssetMetadataResponse", "description": "A JSON with the metadata of the user uploaded asset." }, "errorCode": { "default": null, "description": "The code associated with the status. For example if error the reason behind it", "example": "asset_upload", "allOf": [ { "$ref": "#/components/schemas/PublicApiUserUploadedAssetErrorCodes" } ], "nullable": true } }, "required": [ "id", "title", "contentType", "status", "metadata" ], "title": "GetPublicApiUserUploadedAssetResponse", "type": "object" }, "Error": { "type": "object", "properties": { "error": { "type": "string" }, "context": { "type": "string" } }, "required": [ "error" ] } }, "securitySchemes": { "api_key": { "type": "apiKey", "in": "header", "name": "Authorization" } } } } ``` # Sibling pages * [Create media asset](https://docs.synthesia.io/reference/create-media-asset.md)