Upload media

Returns a presigned URL. PUT the file bytes to signedUrl, then pass publicUrl in a post’s media array.

Category: Media
Calls: POST/v1/media/upload
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

fileNamestringrequired

Original file name, including extension.

fileTypestringrequired

MIME type, for example image/jpeg or video/mp4.

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

A tool call as an MCP client would send it.

{
  "name": "upload_media",
  "arguments": {
    "fileName": "Acme Corp",
    "fileType": "string"
  }
}