Skip to content
Sign InDashboard
Tools

upload_motion_asset

Connect in ChatGPT

For a local image, video or audio file the design should be given: returns a signed upload_url. Send the file there (HTTP PUT, multipart, header x-upsert: false), then call finish_motion_upload to get the attachment_url to pass in attachments. Files are kept for 14 days. 100 uploads per 5 hours.

Access token · edit · Changes account data

Parameters

filename string required
View schema
filename schema
{
  "type": "string",
  "minLength": 1,
  "maxLength": 240
}
content_type string required

For example image/png or video/mp4.

View schema
content_type schema
{
  "description": "For example image/png or video/mp4.",
  "type": "string",
  "minLength": 1,
  "maxLength": 120
}

Request example

Tool request · example
{
  "name": "upload_motion_asset",
  "arguments": {
    "filename": "YOUR_FILENAME",
    "content_type": "YOUR_CONTENT_TYPE"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.