Create Upload Session
create_upload_sessionCreate a browser upload link for media files. ALWAYS use this when the user shares an image or video in chat — their file is local and cannot be passed directly to publish_content.
WORKFLOW:
Call this tool to get an uploadUrl
Give the user the link to open in their browser and upload their file
After upload, call get_upload_session to get the public media URL(s)
Use the returned URL with publish_content or schedule_content
Supports up to 20 files per session. Expires in 15 minutes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mediaType | No | Optional hint for expected media type |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | ||
| status | No | ||
| isError | No | ||
| success | No | ||
| mediaUrl | No | ||
| expiresAt | No | ||
| mediaType | No | ||
| mediaUrls | No | ||
| sessionId | No | ||
| uploadUrl | No | ||
| mediaItems | No | ||
| errorMessage | No | ||
| followUpSuggestions | No |