Update a lead magnet
update_lead_magnetChange a lead magnet's landing page texts, form settings or placement, or render its PDF again from the ebook as it is now (refreshPdf; same address, leads and numbers). Send only what changes. On a DRAFT or paused one the changes apply at once. On a LIVE one nothing is applied: the call returns the exact changes; show them to the user and repeat the same call with confirmLiveChange: true only after they agree. Applying to a live lead magnet needs the magnets:publish permission.
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": {
"magnetId": "<magnetId>"
},
"name": "update_lead_magnet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | The page's path under the Library: lowercase letters, numbers and single hyphens, up to 60 characters. Defaults to one made from the title. | |
| title | No | The landing page's title. | |
| featured | No | Show it first on the Library (one per Library). | |
| headline | No | The line under the title; also the search result title when set. | |
| magnetId | Yes | From list_lead_magnets. | |
| showCount | No | Show how many people downloaded it, once that is 100 or more. | |
| emailGuide | No | Also email the reader a copy (default true). | |
| refreshPdf | No | Render the PDF again from the ebook as it is now (same address, leads and numbers). | |
| consentText | No | The consent sentence beside the required checkbox. Omit to keep Unplain's default sentence. | |
| description | No | What the reader gets and why; shown on the page and in search results. | |
| whatsInside | No | Up to 5 short lines for "What's inside"; null lets Unplain pick them from the PDF. | |
| allowSharing | No | Let readers make share links for colleagues. | |
| nameRequired | No | Ask for a name as well as the email. | |
| showOnLibrary | No | List it on the Library page (false = reachable only by its link). | |
| confirmLiveChange | No | Required for any change visitors would see: on a LIVE lead magnet, on one still paused by the plan (it returns to live by itself), a new slug for a published one, or featured. Call first without it to get the list of changes, show them to the user, and repeat with true only after they agree. | |
| linkTrackingInDownload | No | Count clicks on links inside the downloaded PDF. |