How it works
Critical for the 'client already has the URL' use case. The share URL stays identical — client sees the new round next time they open it. Old round is preserved in history.
Inputs
Name
Type
Required
Description
shareId
string
required
Share to revise.
replacements
Array<{ imageId, newImageId?, newB2Url }>
required
Each entry swaps one old image for one new. Min 1.
providerNote
string
optional
Note shown to client about what changed.
Returns
{ shareId, revised: true }Examples
Swap a single image without changing the URL
Client pointed out one ad had a typo. Edit it, upload the fix, revise_share. Same URL, fresh image.
{
"shareId": "sCfYu_Wvvw",
"replacements": [
{
"imageId": "tWPy4PRDSiTs2gGHJoVQ",
"newImageId": "93KLK5E7mNnHxXsDftsg",
"newB2Url": "https://..."
}
],
"providerNote": "Removed location text from the EV Trio square ad."
}Related tools
create_shareCreate a public share link
Bundle images for a brand into a public share link clients can review without logging in. 30-day TTL.
upload_imageUpload an image into your Claivra account
Push a base64 image you already have on disk (cropped, resized, brand-overlayed) into your Claivra media library — usable in create_share, revise_share, edit_image.