> For the complete documentation index, see [llms.txt](https://docs.agenticflow.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agenticflow.ai/workflows/workflow-inputs/upload-video.md).

# Upload Video

The **Upload Video** control is an input component that allows a user to upload a video file (e.g., MP4, MOV, WEBM) when they run a workflow. The uploaded video is then accessible via a temporary URL that can be used by downstream nodes.

## When to Use

Use the Upload Video control for any workflow that needs to process a user-provided video file. Common use cases include:

* Transcribing the audio track of a video to text.
* Analyzing video frames or content (with a capable model).
* Creating summaries or highlight reels from a longer video.
* Watermarking or clipping a video.

## How to Add

1. From your workflow's **Build** page, click on **+ Add Input**.
2. Select **Upload Video** from the list of available controls.

## Configuration

* **Title:** The main label for the file upload field.
* **Description:** Optional helper text to provide more context.
* **Variable Name:** The name used to access the URL of the uploaded video file.
* **Optional/Required:** A toggle to specify if the user must upload a file.

## Accessing the Value

After the user uploads a file, this control outputs a temporary, secure URL pointing to that video file. This URL is accessible via the variable name you assigned.

For example, if the variable name is `source_video`, the value of `{{source_video}}` will be a URL (e.g., `https://cdn.agenticflow.ai/.../presentation.mp4`).

**Note:** This URL is temporary and will expire. It is meant for immediate processing within the workflow run.

### Example

**Goal:** Allow a user to upload a video of a presentation and get a text transcript of the audio.

1. **Add an Upload Video Control:**
   * Title: "Upload Presentation Video"
   * Variable Name: `presentation_url`
2. **Add an OpenAI MCP Node (Whisper):**
   * **Action:** `Create Transcription`
   * **File:** `{{presentation_url}}`
   * **Purpose:** To extract and transcribe the audio from the video file.
3. **Add a Save to File Node:**
   * **File Name:** `presentation_transcript.txt`
   * **Content:** `{{openai_mcp_1.text}}`
   * **Purpose:** To save the final transcript.

This workflow provides a simple but powerful way to convert video content into searchable, analyzable text.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.agenticflow.ai/workflows/workflow-inputs/upload-video.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.