Add the brand logo to an image
brandImageAdd the brand's logo to an image from the workspace media library and save the result as a new media file; the original file is left unchanged. No AI model is involved and no credits are used. The logo and colours come from the brand voice that applies: the workspace default, the voice of a given channel, or a voice named explicitly. The logo variant (for light or dark backgrounds) is chosen by the brightness of the area it covers, and blank logo files are skipped. Optional extras: a frame in the brand's primary colour and a caption band of short text along the bottom in a brand colour. PNG images stay PNG; JPEG and WebP images are saved as JPEG. Returns the saved file: url, mediaId, path, width, height and fileSize in bytes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "brandImage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| frame | No | Draw a border in the brand's primary colour | |
| mediaId | No | Media library file id of the image (PNG, JPEG or WebP) | |
| fileName | No | File name for the new image; the matching extension is added when missing | |
| folderId | No | Media library folder id to save into. Default: the original image's folder | |
| mediaUrl | No | Media library URL of the image (https://cdn.repeatpost.com/...), as an alternative to mediaId | |
| channelId | No | Channel id (uuid) of a connected channel; its brand voice is used | |
| logoScale | No | Logo width as a fraction of the image's shorter edge (0.05-0.5). Default 0.16 | |
| brandVoice | No | Brand voice name. Default: the voice that applies to the workspace or to channelId | |
| captionStrip | No | Short text (up to 120 characters) set on a band along the bottom in a brand colour | |
| logoPosition | No | Where the logo goes. Default bottom-right |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| output | No |