uploadFromUrlTool
Upload a remote image or video into the media library from a public http(s) URL. Local or private files cannot be fetched by this tool: upload them with the public API (POST /public/v1/upload with an API key, https://hookbird.ai/docs/public-api/introduction). Use this before scheduling a post when the user provides an external media URL (not already hosted on our domain), so the attachment passes the upload-domain validation. Returns the hosted media { id, path } to use as an attachment (or as the src of an in the content, when the channel rules say pictures go inside the content), or { error } on failure.
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": "uploadFromUrlTool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The public http(s) URL of the image or video to upload. Local files and private hosts are not supported, use POST /public/v1/upload instead |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| path | No | ||
| error | No |