Upload media with an AI assistant

Hosted MCP supports media uploads and imports. These tools are not REST endpoints.

Import a public file

Ask your assistant to import a direct image or video URL. It uses import_media_from_url to save the file to your account's Media Library. Preview pages and private file links are not suitable.

Upload a local file

Your assistant's app must be able to read the file and send a multipart upload:

1. create_media_upload returns uploadId, uploadToken, and upload instructions for the supplied file name, type, and size.
2. The app uploads the file to upload.url, including every returned upload.fields value and the file itself.
3. complete_media_upload verifies and saves the file using uploadId and uploadToken.

The temporary upload is not ready to use before completion succeeds. Supported file types are JPG, PNG, GIF, MP4, and MOV, up to 209,715,200 bytes (200 MiB).

Use the returned media record for later operations. Where supported, hosted MCP post tools accept its coverMediaId for a video cover. REST post routes currently reject that field.

See the tool reference and connection guide.