NOIZDocs
DashboardGet started

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
}