---
title: "Modifie la destination, le libellé ou l'ADRESSE d'un lien (`domain` et/ou `slug`), ou l'archive. Changer d'adresse ne casse rien : l'ancienne adresse continue de rediriger vers le même endroit et ses clics comptent sur ce lien (`previousShortUrls`) ; les placements qui partageaient son domaine le suivent. Un lien n'est JAMAIS supprimé : archivé, il cesse de rediriger (anciennes adresses comprises) mais son historique reste."
method: PATCH
path: "/api/v1/links/{id}"
tags: ["links"]
---

# Modifie la destination, le libellé ou l'ADRESSE d'un lien (\`domain\` et/ou \`slug\`), ou l'archive. Changer d'adresse ne casse rien : l'ancienne adresse continue de rediriger vers le même endroit et ses clics comptent sur ce lien (\`previousShortUrls\`) ; les placements qui partageaient son domaine le suivent. Un lien n'est JAMAIS supprimé : archivé, il cesse de rediriger (anciennes adresses comprises) mais son historique reste.

`PATCH /api/v1/links/{id}`

## Request

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

## Path parameters

- `id` string, required

## Request body

- object
  - `destination` string: Nouvelle URL d'arrivée (liens parents seulement).
  - `label` string: Nouveau libellé.
  - `archived` boolean: true pour archiver, false pour réactiver.
  - `domain` string: Nouveau domaine de l'adresse (« liens.votresite.fr »), vérifié dans le compte et libre pour l'espace du lien ; « sbtq.link » pour revenir au domaine partagé. L'ancienne adresse continue de marcher.
  - `slug` string: Nouveau raccourci. Pris sur le domaine visé : erreur `slug_taken`, avec un raccourci libre proposé dans `details.suggestion`.

## Response `200`

Succès.

## Other responses

- `201`: Créé.
- `400`: Paramètres invalides.
- `401`: Clé absente ou révoquée.
- `402`: Quota de la formule atteint.
- `403`: La clé n'a pas le droit demandé.
- `404`: Introuvable dans ce compte.
- `409`: Conflit — un raccourci déjà pris, par exemple.

---

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