---
title: "Edit, tag, archive, or restore a link"
method: PATCH
path: "/api/links/{id}"
---

# Edit, tag, archive, or restore a link

`PATCH /api/links/{id}`

## Request

- Base URL: `https://app.whooshly.co`
- URL: `https://app.whooshly.co/api/links/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `destination` string, uri: http(s) URL
  - `slug` string
  - `title` string, nullable
  - `tags` string[]
  - `active` boolean
  - `archived` boolean

## Response `200`

Updated

## Other responses

- `404`: Error — `error` is a stable code. Common: core_locked (account hasn't purchased — buy at the app), pro_required (feature needs Pro), slug_taken, limit_reached, not_found, rate_limited, invalid (see issues).

---

[API](https://skmtc.dev/whooshly/apis/whooshly-api.md) · [All operations](https://skmtc.dev/whooshly/apis/whooshly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whooshly/apis/whooshly-api/revisions/ccdcdffb18d5?raw)