Add media from a URL
upload_mediaDownload a publicly reachable image or video into the user's media library and return a mediaId for create_post. The file is fetched by the server from the URL you give — you do not send bytes. Accepts jpeg, png, webp, mp4, mov and webm; images up to 10MB (less on X, Instagram, Threads, Facebook, Bluesky and Google Business: check_limits measures it), video up to 1GB. Adding to the library publishes nothing.
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": {
"url": "<url>"
},
"name": "upload_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | A public https URL to the image or video. | |
| organizationId | No | Which organization to act in: an id from list_organizations. Leave out for this connection's default organization. |