---
title: "Get Signed Upload URL"
description: "Get a pre-signed S3 URL for direct file upload to Speak AI storage."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Signed Upload URL

Use the Speak AI MCP server tool `get_signed_upload_url` to get a pre-signed S3 URL
for direct file upload to Speak AI storage.

## What does it do?

Get a pre-signed S3 URL for direct file upload to Speak AI storage. After getting
the URL, PUT your file to it, then call `upload_media` with the S3 URL. For a
simpler workflow, use `upload_local_file` instead which handles all steps
automatically.

## Parameters

`get_signed_upload_url` takes 3 parameters, all of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isVideo` | boolean | Yes | Set true for video files, false for audio files |
| `filename` | string | Yes | Original filename including extension |
| `mimeType` | string | Yes | MIME type of the file, e.g. "audio/mp4" or "video/mp4" |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `get_signed_upload_url`.

- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Media library](/mcp/tools/media/) lists the rest of the Media library category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/media/get_signed_upload_url/index.mdx