Delete Link

Permanently deletes a link and its associated analytics data. The short code is released and can be reused.

Caution

This action is irreversible. All scan history for the link is permanently removed. If you want to temporarily disable a link without deleting it, use the Update Link endpoint to set enabled to false.

DELETE /v1/links/{link_id}

links:write

Path Parameters

Parameter	Type	Required	Description
link_id	string (UUID)	Yes	The unique identifier of the link to delete.

Request Examples

curl

curl -X DELETE https://xqr.co/api/v1/links/d47f2e1a-8c3b-4a5d-9e6f-1234567890ab \
  -H "Authorization: Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

TypeScript

const linkId = "d47f2e1a-8c3b-4a5d-9e6f-1234567890ab";

const response = await fetch(`https://xqr.co/api/v1/links/${linkId}`, {
  method: "DELETE",
  headers: {
    Authorization: "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  },
});

console.log(response.status); // 204

Python

import httpx

link_id = "d47f2e1a-8c3b-4a5d-9e6f-1234567890ab"

response = httpx.delete(
    f"https://xqr.co/api/v1/links/{link_id}",
    headers={
        "Authorization": "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
)

assert response.status_code == 204

Response

204 No Content

The response body is empty on success.

If the link does not exist or belongs to a different workspace, the API returns 404 Not Found.