Prepare Video Upload With Your AI Assistant
Opens the inline upload widget in apps that support it, so you can pick a file from your own device. The file uploads straight from your browser to Dadan.
“I want to upload a video file from my laptop”
How It Behaves
Makes changes in your Dadan account, within what your account is allowed to do.
Parameters
| Name | Type | Description |
|---|---|---|
title | Type: string | Title for the video in Dadan. Optional. |
file_name | Type: string | File name — supplied by the upload widget once the user picks a file. Omit on the first call. |
file_size_bytes | Type: integer | File size in bytes — supplied by the upload widget. Omit on the first call. |
duration_seconds | Type: number | Video length in seconds (decimals allowed) — supplied by the upload widget when it can read it. Omit if unknown. |
You don’t fill these in yourself. Your assistant reads the schema and passes the values from your request.
Description Sent to AI Assistants
Prepare a browser-direct upload into Dadan: opens the inline upload widget (in clients that support MCP Apps) where the user picks a local video file; the bytes then go straight from the browser to Dadan's storage — never through the chat or the gateway. Call it with just an optional title to show the picker; the widget itself calls back with file_name, file_size_bytes and duration_seconds to mint the upload ticket. For uploading from a public URL use upload_video instead. Max 500 MB per file. FALLBACK for agents with shell access to a LOCAL file (when the client can't render the widget or its sandbox blocks browser uploads): call this tool yourself with the file's real file_name + file_size_bytes (and duration_seconds, e.g. from ffprobe, so Dadan shows the right length), then TUS-upload the file to the returned tus_endpoint (e.g. with curl) following the ticket's message; Dadan processes it automatically once the bytes land. VISUAL TOOL: the result renders as an interactive card in the chat in clients that support MCP Apps. Call it whenever the user wants to SEE this — do not answer from prior context. After it returns, reply with ONE short sentence; the card shows the details, so never repeat its titles, links, or stats as text.
Known Limitations
- Mints a resumable TUS ticket. Bytes go from the caller straight to upload.dadan.io — they never pass through this gateway or the model. Some client sandboxes block the browser upload widget; in that case perform the TUS flow directly.
Good to Know
Does prepare_upload Change Anything in My Dadan Account?
Makes changes in your Dadan account, within what your account is allowed to do.
Does prepare_upload Use AI Credits?
No. It does not spend AI credits.
How Do I Use prepare_upload?
Connect Dadan to your assistant (setup guides) and ask in plain language, for example: “I want to upload a video file from my laptop”. You never type the tool name; your assistant picks it.
Video Editing & Lifecycle
Related Tools
archive_video Archive Video
Archives a video, a soft-delete you can undo. Nothing is permanently removed, and you can bring it back with a restore.
clone_video Clone Video
Duplicates a video within the same library, handy for making a variant before you edit. You get back the copy's id.
make_video_public Make Video Public
Makes a video public so anyone can watch, or switches it back to private. This is a publishing action, and the change is verified by read-back: if Dadan doesn't persist it, you get an error rather than a false success.
move_video Move Video
Moves a video into a different folder or library.
restore_video Restore Video
Brings back a video you archived earlier.
schedule_video Schedule Video
Schedules when a video goes live, using an ISO-8601 time in UTC, with an optional end time to unpublish it.
Give Your Assistant Your Video Library
One URL and one sign-in with the Dadan account you already use. No API key, no client secret, nothing to install.