Tools
update_link
Changes a link's title or address, or shows or hides it. Leave out what should stay as it is.
page:writeReplaces something on the pageSame result when repeatedChanges a public page
Shown in apps as Change a link. Offered to an app allowed to change your links, name, bio and location.
Parameters
link_iduuidrequired
A link's id, from get_my_page
titlestringoptional
What the button says, up to 100 characters
urlstringoptional
A web address, an email address or a phone number. 1 to 2048 characters.
visiblebooleanoptional
false hides the link without removing it
Returns
Confirmation that the link changed. Fields left out stay as they are.
Changes show on your public page within about a minute. The change is recorded in your account's activity with the app's name.
Example
You ask:
Rename my Spotify link to Listen on Spotify.
The app calls:
tools/call · update_link
{
"name": "update_link",
"arguments": {
"link_id": "6f1c…",
"title": "Listen on Spotify"
}
}Hints
annotations
{
"title": "Change a link",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}