Edit Link
API to update the information of a generated short URL.
Allowed only when the link type is URL
. Other types (Post Link, Form Link, Button Link, etc.) will not be updated even if the API is called.
PUT
/api/link/v2/update
{
"linkId": "4Rt3",
"domain": "https://vvd.bz",
"ttl": "new title",
"memo": "new my memo"
}
Request Parameters
- linkIdstringrequired
- Link ID.
If the URL is “https://vvd.bz/fML”, the link ID is fML. - domainstringrequired
- Default:https://vvd.bz
- Link domain.
- redirectTypeinteger
- Default:302
- Enum:200301302
- Redirect type.
See Terminology for details.This feature is available on Personal plans and above.
- grpIdxinteger
- Used to group links.
Group IDX can be retrieved with the Link Group List API or from the dashboard. - urlstring
- Original URL. Up to 3,000 bytes are allowed.
This feature is available on Premium plans and above.
- ttlstring
- Link title.
- descriptionstring
- When
redirectType
is200
, the description meta tag can be set. - metaImgstring
- When
redirectType
is200
, the image meta tag can be set.
The image URL must start withhttps://
. - memostring
- Notes for link management.
- notfSubscYnstring
- Default:N
- Enum:YN
- Push subscription link.
If set toY
, a landing page opens before redirecting to the original URL and asks for push notification permission.
If the user denies or cancels, they are redirected immediately to the original URL. - pushNotifyYnstring
- Default:N
- Enum:YN
- Push notifications for clicks.
If set toY
, notifications are sent to devices with the Vivoldi app whenever the configured click count is reached (set in Dashboard → Settings).This feature is available on Personal plans and above.
- mailNotifyYnstring
- Default:N
- Enum:YN
- Email notifications for clicks.
If set toY
, email alerts are sent whenever the configured click count is reached (set in Dashboard → Settings).This feature is available on Personal plans and above.
- delYmdtdatetime
- Scheduled link deletion date.
After this date, the link is automatically deleted.
Example: 2025-08-30 23:59:59
{
"code": 0,
"message": "",
"result": null
}
Response Parameters
- codeinteger
- Response code: 0 = Success, other values = Error
- messagestring
- Response message. If the response code is not 0, an error message is returned.
- resultnull