Import Media From URL
media_import_urlImport video, audio, images, fonts, SVG or JSON from a direct URL into the private workspace library. Returns a durable asset ID and verified contentHashSha256. Fonts, SVG and JSON are limited to 25 MiB.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "media_import_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | URL of the media file to download and upload | |
| name | No | Optional name for the file | |
| projectId | No | Optional project ID to associate the upload with. UUID string. | |
| workspaceId | No | Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string. | |
| autoTranscribe | No | Request transcription for video uploads. | |
| autoSuggestShorts | No | ||
| contentHashSha256 | No | Optional expected SHA-256; mismatching bytes are rejected before deduplication. 64-character hex string. | |
| autoProcessEnabled | No | Enable media analysis after upload. | |
| autoDescribeAfterTranscribe | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media | Yes |