Documentation

Update a link

PATCH/v1/links/{link}Links

Changes the destination, title, redirect type, QR style, or switches the link off and on. Send only the fields to change. The edge cache follows within a minute. Also available as the MCP tool update_link.

Parameters

Parameter	Type	Required	Description
`link`	string, in the path	required	The link's id, or its ending.

Request body

JSON, sent with Content-Type: application/json.

Field	Type	Required	Description
`url`	string	optional	A new destination. Printed codes follow at once.
`title`	string, null	optional
`redirect`	301 \| 302	optional
`disabled`	boolean	optional	True switches the link off (404); false switches it back on.
`qr_style`	QrStyle	optional	How the link's QR code is drawn in the dashboard and at its image URLs.
`qr_style.style`	rounded \| square	optional	Dot shape.
`qr_style.fg`	string	optional	Dark colour, #rrggbb.
`qr_style.bg`	string	optional	Light colour, #rrggbb.
`qr_style.ecc`	L \| M \| Q \| H	optional	Error correction level.

Example request

curl -s -X PATCH "https://snip.link/v1/links/spring-menu" \
  -H "Authorization: Bearer $SNIP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/menus/summer-2026"}'

Example response

{
  "link": {
    "id": "lnk_7f0c2a2b4bb04a8b",
    "code": "spring-menu",
    "short_url": "https://snip.link/spring-menu",
    "url": "https://example.com/menus/spring-2026",
    "title": "Spring menu",
    "redirect": 302,
    "disabled": false,
    "clicks": 1284,
    "qr_style": {
      "style": "rounded",
      "fg": "#111111",
      "bg": "#ffffff",
      "ecc": "M"
    },
    "qr_png_url": "https://snip.link/qr.png?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "qr_svg_url": "https://snip.link/qr.svg?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "created_at": "2026-10-01T09:12:40.000Z",
    "updated_at": "2026-10-18T16:03:11.000Z"
  }
}

Response fields

Field	Type	Description
`link`	Link
`link.id`	string	Stable id. Every link route accepts it, or the ending.
`link.code`	string	The ending: the path after snip.link/.
`link.short_url`	string	The short link, ready to share or print.
`link.url`	string	Where the link goes now. Change it any time; printed codes follow.
`link.title`	string, null	A name for the dashboard. Null when unset.
`link.redirect`	integer	302 (default: every scan is counted) or 301 (browsers may cache the hop).
`link.disabled`	boolean	A disabled link answers 404 until it is enabled again.
`link.clicks`	integer	Every click and scan since the link was made.
`link.qr_style`	QrStyle	How the link's QR code is drawn in the dashboard and at its image URLs.
`link.qr_png_url`	string	The link's QR code as PNG (512 px). Free, no key.
`link.qr_svg_url`	string	The same code as SVG, for print.
`link.created_at`	string
`link.updated_at`	string

Errors

Status	Meaning
400	The body or query is invalid. `details` names each field.
401	The API key is missing, malformed or revoked.
404	No link by that id or ending in this account.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).

Back to the guide