Post Media Upload
post_media_uploadUpload an image or video from a public HTTPS URL and return its media ID for post creation or scheduling; the address must report the file size.
Instructions
Upload an image or video for a post from a public https address (JPEG, PNG, WebP or GIF, MP4 or MOV, up to 1 GB; the address has to report the file size). Returns the media with its id: pass it as media to post_create or post_schedule. An upload no post uses is removed after a while.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organizationId": "<organizationId>",
"url": "<url>"
},
"name": "post_media_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https:// address of the file. Private or local addresses are refused. | |
| fileName | No | File name to keep. Default: the last part of the address. | |
| durationMs | No | Videos: the length in milliseconds, when known. The checks for Shorts and Reels use it. | |
| contentType | No | MIME type, e.g. image/jpeg or video/mp4. Default: what the address reports. | |
| organizationId | Yes | The organization id. Use organization_list to find it. |